Genera Handbook 



HELP Key 

The key labelled HELP looks up context-dependent documentation. Pressing HELP al- 
most always displays something useful. For example, if you have typed se to the 
Command Processor, and then are not sure what command you actually want, 
pressing HELP displays: 

These are the possible connand nanes starting with "se": 
Select Rctiuity 
Send ... (2) 
Set ... (20) 

Connand: se 

You can use HELP in combination with other keys to get information about those 
keys or about Genera. 



c-HELP Shows a list of input editor commands (when typed at a Lisp 

Listener). 

sy-HELP Shows a list of the special function keys and the special char- 

acter keys. 

SELECT HELP Shows programs and utilities that you can select using the SE- 

LECT key. 

FUNCTION HELP Shows a list of useful functions that you can invoke using the 

FUNCTION key. 



n-HELP 



Shows a helpful hint (HackSaw) for getting things done faster 
and more easily in Genera. 



c-? and c-/ 

When you are not sure of the exact name of a command, there are two keystrokes 
that search the set of available commands and locate possibilities for you. c-? 
searches for commands whose names begin with the string you have typed so far. 
c-/ searches for commands whose names contain the string anywhere. 

For example, in a Lisp Listener, typing start and pressing c-? yields: 

These are the possible command names starting with "start": 
Start GC 
Start Printer 
Start Process 
Start X Screen 

Typing start and pressing c-/ yields: 
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These are the command names containing "start": 

Restart Printer Request Start GC Start Process 
Restart Process Start Printer Start X Screen 



Index of Special Function Keys 



Introduction 

This is a quick reference guide to the Symbolics keyboard special function keys. 
Most of these keys have the same function in any window. However, a few of them 
perform differently in different contexts. If you have a Sun or Macintosh keyboard, 
there is a mapping for finding these function keys on your keyboard. For the 
Mac Ivory keyboard, see the section "Using the Genera Application on a Mac Ivory". 
For the Sun keyboard, see the section "Symbolics UX Keyboard Templates". 



RBORT Key 

RBORT When read by a program, the program stops what it is doing and re- 

turns to its "command loop". Lisp Listeners, for example, respond to 
RBORT by throwing back to the read-eval-print loop (top level or 
zhbreak). Note that RBORT takes effect when it is read, not when it is 
pressed; it does not stop a running program. 

c-RBORT Aborts the operation currently being performed by the process to 
which you are typing, immediately (not when it is read). For instance, 
this forces a Lisp Listener to abandon the current computation and re- 
turn to its read-eval-print loop. 

n-RBORT When read by a program, the program stops what it is doing and re- 
turns through all levels of commands to its "top level". Lisp Listeners, 
for example, throw completely out of their computation, including any 
zhbreak levels, then start a new read-eval-print loop. 

c-n-RBORT A combination of c-RBORT and n-RBORT, this immediately throws out of 
all levels of computation and restarts the current process. 



BACKSPACE Key 

In a Lisp Listener, BACKSPACE moves the cursor back one character, as does c-B, 
so that you can insert additional text or edit. In Zmacs, Converse, and Zmail mes- 
sage windows, it inserts a backspace character into the buffer. In the main Zmail 
window it scrolls the current message backward (as do n-SCROLL and n-U). 



CLEAR INPUT Key 
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Usually erases the expression you are typing. In an editor buffer CLERR INPUT 
erases from the location of your cursor to the beginning of the current line. If you 
are at the beginning of the line, it erases the previous line. 



COMPLETE Key 

Completes as much as possible of partially typed commands. In Document Examin- 
er, COMPLETE works on topic names. 

n-COMPLETE after a Command Processor or Document Examiner command displays 
a menu of the arguments and keywords for the command you are typing. You can 
then specify the arguments and keywords from the menu using the mouse or the 
keyboard. 

Command: Show System Modifications (for system [default Pill]) HIT 

For system: fill Local pa.tcha.ble systens 

Ruthor: a string 

Before: a universal tine 

From: an integer 

Matching: a string 

Newest: an integer 

Number: an integer 

Oldest: an integer 

Reviewer: a string 

Since: a universal tine in the past 

Through: an integer 

Output-Destination: a destination 

< abort > aborts^ <1S1> uses these values 

See the section "Using Menus". 



END Key 

Marks the end of input to many programs. Single-line input can be terminated 
with RETURN or END. END terminates multiple-line input where RETURN is used to 
separate lines. When you are typing Lisp input, balanced parentheses terminate ex- 
pressions and END is not used. However, if you use the input editor to yank a pre- 
vious command or expression, END terminates it. See the section "Editing Your In- 
put". 



ESCRPE Key 

Displays the mouse-sensitive input editor history for the current window. c-ESCRPE 
displays the global kill history. Sends Escape/Altmode (octal 033) in the Terminal 
program. 

FUNCTION Key 

This key is a prefix for a family of commands relating to the screen, which you 
can type at any time, no matter what program you are running. 
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Display and Hardcopy Commands 

The FUNCTION commands that control screen display and hardcopying are: 

RUBOUT Does nothing; press this key to cancel FUNCTION if you typed the latter 

by accident. 

CLERR INPUT 

Discards typeahead. 

REFRESH Clears and redraws all windows. 

c-REFRESH Dims the screen as if the console has been idle for 20 minutes, or 
brightens the screen, if it has been dimmed. 

R Arrests the process shown in the status line. FUNCTION - R resumes 

the process. 

B Buries the currently selected window, if any — that is, it moves it to 

the bottom of the history of selected windows. This brings up the pre- 
viously selected window, which is automatically selected. It takes nu- 
meric arguments to specify the window to bury: 

or no arg buries the selected window 

1 deactivates the selected window (confirm) 

2 buries the mouse window 

3 deactivates the mouse window (confirm) 

4 buries the top level window on the screen 

5 deactivates the top level window on the screen (confirm) 

C Complements the entire screen. An argument of 1 means white-on- 

black; an argument of means black-on-white. 

c-C Complements the selected window, with the same argument as FUNC- 

TION C. 

n-C Complements the mouse documentation line, with the same argument 

as FUNCTION C. 

FUNCTION E Sets the global default end of page mode. With no argument, it 

prompts with a menu for a new end of page mode. If an argu- 
ment is supplied, it selects one of these possible modes: 

Argument Value and Meaning 

1 Scroll. Scroll text on the viewport upward 
to show the next line. 

2 Truncate. Continue with output beyond the 
end of page, but do not automatically scroll 
up. 
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3 Wrap. Continue with output from the top 

of the viewport, without moving text al- 
ready displayed on the viewport. 

FUNCTION c-E Sets the end of page mode for the selected window. With no 

argument, it prompts with a menu for a new end of page 
mode. If an argument is supplied, it selects one of these possi- 
ble modes: 

Argument Value and Meaning 

Default. When an end of page occurs, use 
whatever action is globally selected at that 
time. The global action is controlled by 
FUNCTION E or Set Screen Options. 

1 Scroll. Scroll text on the viewport upward 
to show the next line. 

2 Truncate. Continue with output beyond the 
end of page, but do not automatically scroll 
up. 

3 Wrap. Continue with output from the top 
of the viewport, without moving text al- 
ready displayed on the viewport. 

If the window does not support an end of page mode, FUNCTION 
c-E just beeps. 

F Shows users logged in on other machines on your network. Arguments 

can be assigned to shows users logged in on various machines at your 
site. FUNCTION O F prompts you for a specific user or host to show. 
Giving a user name followed by /w displays the information in the 
user's namespace entry. 

H Shows status of network hosts. With an argument, it prompts for 

hosts. 

M Controls global More processing. No argument means toggle, means 

turn off, 1 means turn on. 

c-M Controls More processing for the selected window. The arguments are 

the same as for FUNCTION N. 

Selects another exposed window. 

Function Q Captures a screen image for hardcopying or inserting in a file. 

Function n Q (where n is any numeric argument, for example FUNCTION O Q) 

Displays a menu of options for capturing screen images. Note 
that the choices you make remain in effect for subsequent uses 
of FUNCTION D. 
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Source: Whole Screen Main Screen Selected Window Uindou under House Status area Specify rectangle 

Include blinkers and nouse cursor: Yes Mo 
Destination: Printer 

Printer: File <s printer k 

Orientation: Landscape Portrait Best-Fit 

Announcement method : None Beep Flash 

Shutter trigger: Mode Lock Tine delay None 



Figure 123. FUNCTION S D 



Source: options identify the area of the screen to capture: 



Whole Screen 



Main Screen 
Selected Window 



A bitmap image of the entire screen 

Note that a full-screen bitmap image includes a border around 
the actual screen image. If you do not want this extra whites- 
pace around the image, select the Named Image option and 
edit the bitmap image using the "Refit Bounding Box Bitmap 
Editor Command". 

All but the status area 

The window of the selected activity (for example, Symbolics 
Concordia) 



Window Under the Mouse 

The window under the mouse cursor 



Status Area 

Specify Rectangle 
Window History 

Shutter Trigger: 

Mode Lock 

Time Delay 
None 



Use this option when you cannot use the mouse to specify a 
portion of the screen (for instance, to take a snapshot of a pop- 
up menu). 

The window at the bottom of the screen (including the mouse 
information line(s) ) 

Specify the area of the screen to be captured using the mouse 

The history of the specified window 



Captures the image when the MODE LOCK key is pressed. This 
allows you to set up the screen a certain way, perhaps with a 
menu showing, or the mouse cursor in a certain place. 

Allows you to specify a time delay before capturing the image. 
The default is 5 seconds. 

Captures the image as soon as you click on [Done]. This is the 
default. 
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Selection and Notification Commands 

The FUNCTION commands that control window selection and notification are: 

S Selects the most recently selected window. With an argument n (de- 

fault is 2), it selects the nth previously selected window and rotates 
the top n windows in the selected window history. An argument of 1 
steps through each of the previous selected windows in turn (a nega- 
tive argument steps in the other direction); selects a window that re- 
quires attention (for example, to report an error). 

T Controls the selected window's input and output notification character- 

istics. If an attempt is made to output to a window when it is not ex- 
posed, one of three things can happen: 

• The program can simply wait until the window is exposed. 

• It can send a notification that it wants to type out and then wait. 

• It can quietly type out "in the background"; when the window is 
next exposed the output becomes visible. 

Similarly, if an attempt is made to read input from a window that is 
not selected (and has no typed-ahead input in it), the program can ei- 
ther wait for the window to become selected, or send a notification 
that it wants input and then wait. 

The FUNCTION T command controls these characteristics based on its 
argument, as follows: 

no argument If output notification is off, turns input and output 

notification on; otherwise turns input and output 
notification off. This essentially toggles the current 
state. 

Turns input and output notification off. 

1 Turns input and output notification on. 

2 Turns output notification on, and input notification 
off. 

3 Turns output notification off, and input notification 
on. 

4 Allows output to proceed in the background, and 
turns input notification on. 

5 Allows output to proceed in the background, and 
turns input notification off. 

W Controls the status line. With no argument, the status line is redis- 

played. The arguments control the process the status line watches. The 
options are: 
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Gives a menu of all processes, and freezes the sta- 
tus line on the process you select. When the status 
line is frozen on a process, the name of that pro- 
cess appears where your user-id normally would 
(next to the date and time), and the status line 
does not change to another process when you select 
a new window. 

1 The status line watches whatever process is using 
the keyboard, and changes processes when you se- 
lect a new window. This is the default initial state. 

2 Changes the status line so that it displays the 
name of the process instead of the name of the 
user. This also freezes the status line on that pro- 
cess; normally the status line switches to display a 
different process whenever the window system tells 
it to. 

Use this if you see an unexpected state in the sta- 
tus line. It will help you find out what process is 
in that state; you might find that you are not talk- 
ing to the process you think you should be. 

3 Steps the status line through all processes. 

4 Steps the status line in the other direction. 



Recovering From Stuck States 

The following FUNCTION commands should all be used with caution. 

ESCRPE Helps you recover from stuck states such as "Output Hold" and "Sheet 

Lock". 

c-R Arrests all processes except the one shown in the status line and criti- 

cal system processes, such as the keyboard and mouse processes. FUNC- 
TION - c-R resumes all processes arrested by this command. 

SUSPEND Gets to the cold-load stream. 

c-T Deexposes temporary windows. This is useful if the system seems to be 

hung because there is a temporary window on top of the window that 
is trying to type out. 

c-CLERR INPUT 

Clears window system locks. This is a last resort, although not as dras- 
tic as warm booting. Use this when none of the windows will talk to 
you, when you cannot get a System menu, and so on. 
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Debugging and I/O 

D Toggle the DBG flag state. 

c-D Toggle all DBG flags. See the section "Using the Debugger". 

END Inserts an EOF (End of File) indicator into the currently selected I/O 

buffer. 



HELP Key 

The key labelled HELP looks up context-dependent documentation. Pressing HELP al- 
most always displays something useful. For example, if you have typed se to the 
Command Processor, and then are not sure what command you actually want, 
pressing HELP displays: 

These are the possible connand nanes starting with "se": 
Select Rctiuity 
Send ... (2) 
Set ... (20) 

Connand: se 



You can use HELP in combination with other keys to get information about those 
keys or about Genera. 

c-HELP Shows a list of input editor commands (when typed at a Lisp 

Listener). 

sy-HELP Shows a list of the special function keys and the special char- 

acter keys. 

SELECT HELP Shows programs and utilities that you can select using the SE- 

LECT key. 

FUNCTION HELP Shows a list of useful functions that you can invoke using the 

FUNCTION key. 



n-HELP 



Shows a helpful hint (HackSaw) for getting things done faster 
and more easily in Genera. 



LINE Key 

The function of this key varies considerably. It is used as a command by the De- 
bugger, and sends a Line Feed character in the Terminal program. In the editor it 
behaves like a RETURN followed by a TRB to the indentation level appropriate to the 
mode of the editor. See the section "TRB Key". 



LOCRL Key 
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This key controls local console functions on XL-family and 3600-family machines: 

Makes the screen dimmer. 

Makes the screen brighter. 

Makes the audio quieter. 

Makes the audio louder. 

Rings the bell. 

Changes the contrast of the screen, n is a digit between 1 and 
4. 4 is greatest contrast. 



LOCRL-D 
LOCRL-B 
LOCRL-D 
LOCRL-L 
LOCRL-G 
LOCRL-n LOCRL-C 



LOCRL-T 



LOCRL-0 
LOCRL-RBORT 



(Test Mode). Sends input from the keyboard to the console se- 
rial port as ASCII characters. Since most users do not have 
anything connected to the serial port, this effectively usurps 
console input. 

Exits from Test Mode. 

Re synchronizes the console, resetting all LOCRL settings to 
their initial state. 



Related Lisp functions: 

tv: screen-brightness 
sysrconsole-volume 

LOCRL does not work on Maclvory or UX-family machines. 



NETWORK Key 

This key is used to get the attention of the Terminal program. You must be con- 
nected to a host via the Terminal program before you can use this key. See the 
section "Using the Terminal Program". 

Once connected, commands are given by pressing NETWORK and another single 
character. 

The following commands are available: 

NETWORK HELP Displays the list of options for the NETWORK key. 

NETWORK R Sends an ATTN (in Telnet, a new Telnet "Interrupt Process"). 

NETWORK D Disconnects without logging out first. 

NETWORK L Logs out of remote host, and breaks the connection. 

NETWORK D Quits, by disconnecting and deselecting this window. 

NETWORK M Toggles More processing. 

NETWORK K Sets terminal options. 

NETWORK c-Y Sends top of kill ring. 
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NETWORK n-W Wipes marked text. 

NETWORK : Enters an extended network command. The extended commands 

are: 

Set Terminal Simulator Type Set Overstriking 

Set Escape Character Send File 

Set Wallpaper File Send String 

NETWORK H gives you a menu of terminal options to set: 

Terminal connand: 

Escape character: Network 

More processing: Yes No 

Ouerstrike: Yes No 

Wallpapering: Yes No 

Local Echo: Yes No 

Terminal simulator: UT100 Rnbassador Inlac Glass TTY 

< abort > aborts^ <1S1> uses these values 



PRGE Key 



In Zmacs this key inserts a page separator character, which displays as <EEH> . 

REFRESH Key 

Erases and redisplays the selected window. 



REPERT Key 

Repeats the key pressed while the REPERT key is held down. You can press and 
hold down a key and then press the REPERT key, or you can hold down the REPERT 
key and press a key. Once the repetition starts, it continues until you lift your fin- 
ger from the REPERT key. You can lift your finger from the first key and press an- 
other while still holding down REPERT and that key starts to repeat. Pressing the 
REPERT key without pressing any other key does nothing. The REPERT key is en- 
abled by default, but you can disable and reenable it by setting the variable 
si:*kbd-repeat-key-enabled-p* with zhsetf. 

You can have keys repeat if they are held down without using the REPERT key. See 
the section "Auto-repeat". 



RESUME Key 

Continues from the zhbreak function or SUSPEND and from the Debugger. In the 
Terminal program this sends a Backspace character. In Zmail it resumes sending 
the last draft message. 



RETURN Key 



Page 2558 



"Carriage return" or end of line. The exact significance of carriage return varies 
according to context. 



RUBOUT Key 

Erases the last character typed. In More breaks, RUBOUT terminates display. In 
Query Replace operations it means "Skip this replacement and continue." 



SCROLL Key 
Scrolls the display. 

SCROLL Scrolls the display forward. 

n-SCROLL Scrolls the display backward. 

s-SCROLL Scrolls the display to the right. 

n-s-SCROLL Scrolls the display to the left. 

c-SCROLL Initiates scrolling of the history for the typeout window of cur- 

rent window. You use this in conjunction with c-n-SCROLL to 
make use of the display on typeout windows, including break- 
points. 

c-n-SCROLL Used after c-SCROLL, scrolls backward through the history of 

the current typeout window. As with any dynamic window, pre- 
vious commands and arguments are mouse sensitive and can 
be reexecuted or used in composing new commands. 



SELECT Key 

This key is a prefix for a family of commands, generally used to select a window 
of a specified type, such as a Lisp Listener or Zmail. The current list is: 



= 


Select Key Selector 


c 


Converse 


D 


Document Examiner 


E 


Editor 


F 


File System Maintenance Operations 


I 


Inspector 


L 


Lisp 


M 


Zmail 


N 


Notifications 


P 


Peek 


D 


Frame-Up 


T 


Terminal 


K 


Flavor Examiner 
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SELECT c- creates a new window of the specified type. 

Your applications can be assigned to a key for use with SELECT. See the function 
tv:add-select-key. Numeric keys are not valid for use with SELECT. You can cus- 
tomize which applications are assigned to which keys. See the section "Customizing 
the SELECT Key". 



SUSPEND Key 

SUSPEND Usually forces the process to which you are typing into a zhbreak 
read-eval-print loop, so that you can see what the process is doing, or 
stop it temporarily. The effect occurs when the character is read, not 
immediately. Press RESUME to continue the interrupted computation 
(this applies to the three modified forms of the SUSPEND key as well). 
While you are in the break, elements of your history in the other win- 
dow remain mouse sensitive so you can yank them into the break for 
experimentation. 

c-SUSPEND Like SUSPEND, but takes effect immediately rather than when it is 
read. Press RESUME to continue the interrupted computation. 

n-SUSPEND Forces the process to which you type it into the Debugger when it is 
read. It should type out ">>BRERK:", any proceed options, and the De- 
bugger prompt "— >". You can examine the process, then press RESUME 
or s-R to continue. 

c-n-SUSPEND 

Forces the current process into the Debugger, whether or not it is 
running. 



SYMBOL Key 

Acts as a modifier key to produce special characters. Pressing sy-HELP produces a 
display of special function and special character keys. 



TRB Key 

In general, TRB moves the cursor to an appropriate point to the right. The LINE 
key is related to TRB. If you change the behavior of the TRB key, the behavior of 
LINE can be affected. 

When you are typing a Command Processor command, TRB can be used to termi- 
nate a command field, effectively making the field a quoted string. This solves the 
left-substring problem, accept and completion prefer long completions. For example, 
if you want to display the documentation for the topic "Using the Mouse", and you 
type 



Show Documentation (for Topic) Using the Mouse < complete > 
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Completion does not find "Using the Mouse" since it is looking for the longest 
topic name. Pressing HELP produces: 

These are the possible docunentati on topics starting with "Using the Mol 
Using the Mouse and the Keyboard on Menus 
Using the Mouse in the Debugger 
Using the Mouse in the Metering Interface 
Using the Mouse on History Elements 

Press <2E1> for "Using the Mouse" 

Connand: Show Docunentati on (for topic) Using the Mouse 

If you then press TRB, you see: 
Connand: Show Docunentati on (for topic) "Using the Mouse" (keywords) 



Keys Not Currently Used 

The following key currently has no function: 

MODE LOCK 

The following keys are reserved for use by the user (for example, for custom edi- 
tor commands or keyboard macros): 

CIRCLE 
SDURRE 
TRIRNGLE 
HYPER 



Input Editor Commands 

Input Editor Commands: c-number, c-Minus and c-U provide numeric arguments. 

Refresh Refresh Window 

Page Erase Typeout 

n-< Beginning Of Buffer 

n-> End Of Buffer 

Clear-Input Clear Input 

c-F Forward Character 

c-B Backward Character 

c-D Delete Character 

Rubout Rubout Character 

c-T Exchange Characters 

c-R Beginning Of Line 

c-E End Of Line 

c-P Previous Line 

c-N Next Line 

c-K Kill Line 
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n-F Forward Word 

n-B Backward Word 

n-D Delete Word 

n-RUBOUT Rubout Word 

n-T Exchange Words 

n-U Upcase Word 

n-L Downcase Word 

n-C Capitalize Word 

c-n-F Forward Expression 

c-n-B Backward Expression 

c-n-K Delete Expression 

c-n-RUBOUT Rubout Expression 

c-n-) Forward Up Parentheses 

c-n-( Backward Up Parentheses 

c-n-U Backward Up Parentheses 

c-n-D Forward Down Parentheses 

c-n-R Beginning Of Definition 

c-n-E End Of Definition 

c-n-T Exchange Expressions 

n-( Make () 

LINE New Line 

BRCK-SPRCE Backward Character 

c-L Refresh Window 

c-0 Open Line 

c-D Quote Character 

c-n- J Set Typein Style 

HELP Display Documentation 

c-HELP Display Commands 

ESCRPE Display Input History 

c-ESCRPE Display Kill History 

c-Y Yank 

n-Y Yank Pop 

c-n-Y Yank Input 

c-W Kill Region 

n-W Save Region 

c-Space Set Mark 

c-< Mark Beginning 

c-> Mark End 

c-sh-Y Yank Matching 

n-sh-Y Yank Pop Matching 

c-n-sh-Y Yank Input Matching 

SCROLL Scroll Vertical Forward 

c-U Scroll Vertical Forward 

n-SCROLL Scroll Vertical Backward 

n-U Scroll Vertical Backward 

s-SCROLL Scroll Horizontal Forward 

s-n-SCROLL Scroll Horizontal Backward 

c-n-S Save Scroll Position 
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c-n-R Restore Scroll Position 

s-W Kill Ring Push Region Strings 

s-G Kill Ring Clear Region Strings 

c-S Scroll Search Forward 

s-S Scroll Search Forward 

c-R Scroll Search Backward 

s-R Scroll Search Backward 

c-sh-R Describe Arguments 

c-sh-U Describe Variable 

c-sh-D Document Symbol 

n-sh-R Lookup Function Documentation 

n-sh-U Lookup Variable Documentation 

n-sh-F Lookup Flavor Documentation 

n-HELP Show Hacksaw 



Quick Summary of Mouse Functions 

Mouse Cursor Shape 

These are some of the more common mouse cursors: 



* * 



t $ 



X ++ 



x 



A thin arrow pointing North by Northwest (up and to the left). 
This is the default mouse cursor. The mouse documentation 
line indicates any special commands. If the mouse is over a 
partially exposed window, clicking left selects that window. 
Clicking sh -Right gets you the System menu. The arrow ap- 
pears hollow when mouse sensitivity is being computed and 
fills in black when the computation has completed. 

A thin arrow pointing North by Northeast (up and to the 
right). This means the mouse is in an editor window. There 
are a number of editor commands on the mouse buttons. See 
the section "Mouse Documentation Line in Zmacs". 

A slightly thicker arrow pointing North (straight up). The edi- 
tor and the Command Processor use this to show that it is ask- 
ing you for the name of a function or for a symbol. If you 
point the mouse at a function name, and stop moving it, the 
name is highlighted and you can click to select it. 

A double-headed arrow pointing north and south (up and down) 
or east and west (side to side). This indicates the mouse is in 
a scroll bar or can be used for scrolling. 

A small x. This is used when the mouse cursor should be un- 
obtrusive, for instance in menus. 
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Mouse Gestures on Dynamic Windows 

Left On a directory listing, does a Show File of the highlighted file. 

In Other contexts yanks the command line. 

sh-Left Like Left, but also activates. Click sh-Left on a command line 

to yank and activate the command. 

c-Left Marks a region; s-W pushes the marked region on the kill ring. 

c -Right Brings up the Marking and Yanking menu. 

Middle On a Lisp object does a describe of the object. 

c -Middle Yank the word the mouse is over. Useful for using arbitrary 

text to compose commands; for example, after a Show Mail 
command, click c -Middle on a pathname mentioned in a mail 
message as an argument to Show File. 

Right on an object Brings up a menu of possible operations on the object. 

n-sh-Right Gets the menu of window operations. 

n-Left in Zmacs Edit Definition. Hold down the METR key and move the mouse 
around to see what is mouse sensitive. 

n-Middle in Zmacs Evaluate form. Hold down the METR key and move the mouse to 
see what is mouse sensitive. 



Scrolling with the Mouse 

Windows display "contents" that are too big to fit entirely in the window. When 
this is the case, you see only a portion of the contents, and you can scroll the con- 
tents up and down using the mouse. 

Dynamic windows all have scroll bars along one side. The default position for the 
scroll bar is along the left side. You can position the scroll bar along the right 
edge if you prefer. See the section "Adjusting Console Parameters". Some dynamic 
windows have horizontal scroll bars across the bottom. 

When the mouse is moved over the scroll bar its cursor becomes a double-headed 
arrow. A gray area in the scroll bar indicates what portion of the window's con- 
tents is visible. The position of the gray area within the scroll bar shows the posi- 
tion of the visible portion of the window's contents relative to the whole. At each 
end of the scroll bar are small boxes. 

Clicking the mouse in the box at the top of vertical scroll bars scrolls by lines. 
Clicking the mouse in the box at the left of horizontal scroll bars scrolls by 
columns. The mouse clicks are: 

Left Scroll by one line (next line) or one column (next column to the right) 

Middle Scroll to the top (first available screen) of the window or to the left- 
most column. 
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Right Scroll to the previous line or the previous column. 

Clicking the mouse in the box at the bottom of vertical scroll bars or the right of 
horizontal scroll bars scrolls by screens. The mouse clicks are: 

Left Scroll to the next screen (move one screen to the right). 

Middle Scroll to the end of the window (last available screen) or the right- 
most screen. 

Right Scroll to the previous screen (move one screen to the left). 

Clicking the mouse in the scroll bar beside the middle of window scrolls propor- 
tionally. The mouse clicks are: 

Left Next screen; position this line at the top line of the screen or 

this column at the left edge of the screen. 

sh-Left Previous screen; position this line at the bottom of the screen 

or this column at the right edge of the screen. 

Middle Position the window at the location corresponding to this per- 

centage of its contents. 

Right Previous screen; position the line that is currently at the top 

line of the screen here or the column that is currently at the 
left edge here. 

Other scrolling conventions with the mouse are: 

• A fat arrow, pointing up or down. This indicates you are in a scrolling zone. 
Moving the mouse slowly in the direction of the arrow scrolls the window, re- 
vealing more of the text in the direction the arrow points. 

• Scrolling zones often say More above or More below in small italic letters. Click- 
ing on one of these legends scrolls the window up and down by its height, dis- 
playing the next or previous screen. When the top or bottom of the window con- 
tents is reached, so that it is not possible to scroll any farther in one direction, 
the legend in the scrolling zone changes to indicate this. 



Selecting a Group of Objects with the Mouse 

You can use the mouse to sweep over an area and select all the mouse-sensitive 
objects of a given presentation type in that area to use as input to a command 
that takes a sequence of arguments. 

For example, type Show Directory sys: examples; . 

Type Show File and position your mouse at the right hand side of the directory 
listing. Click and hold the left mouse button and drag the mouse down and to the 
left. All the pathnames in the rectangle you create by the diagonal motion are 
added as a sequence to the Show File command when you release the mouse but- 
ton. 
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Note that you can mark groups of objects using the click and hold action, but if 
your mouse is over an object of the same type as the group you want to select 
(that is, if your mouse is over a single pathname, in this case), that single object 
is selected. To select a group, your mouse must initially be over a part of the 
screen that is not mouse sensitive. 
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SUSPEND 



Zmacs Quick Reference 



Zmacs Help Facilities 

c-RBORT Aborts the function currently executing. 

c-G Aborts a command when entered, unselects the region, or un- 

merges a kill. 
HELP R string Shows every command containing string (try HELP R Paragr or 

HELP R Buffer). 
HELP C x Explains the action of any command (try HELP C c-K as an ex- 

ample). 

Describes a command (try HELP D Query Rep). 

Displays the last 60 keys pressed. 

Offers to undo the last change to the buffer. 

Shows all Zmacs variables containing string. 

Prompts for an extended command and shows its keybinding. 

Displays these HELP key functions. 

Repeats the last HELP command. 

Starts a Lisp Listener (return from it with RESUME). 



Zmacs Recovery Facilities 

m-K Undo Undoes the last command. 

c-sh-U Undo. 

n-H Redo Undoes the last undo. 

c-sh-R Redo. 

c-Y Yanks back the last thing killed. 

n-Y After a c-Y, successively yanks back older things killed. 

c-sh-Y Prompts for a string to yank. 

n-sh-Y After c-sh-Y, successively yanks back older things containing 
string. 



Extended Commands 

Extended commands (the m-K commands) put you in a small area of the screen 
with full editing capabilities (a minibuffer) for entering names and arguments. Sev- 
eral kinds of help are available in a minibuffer. 

COMPLETE Completes as much of the current command as possible. 
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HELP Gives information about special characters and possible comple- 

tions. 

c-? Shows possible completions for the command currently being en- 

tered. 

END or RETURN Completes the command, and then executes it. 

c-/ Does an apropos on what has been typed so far. 



Writing Files 

c-K c-S Writes the current buffer into a new version of the current file 

name. 
c-K c-W Writes the current buffer into a file with a different name. 

n-H Save File Buffers 

Offers to save each file whose buffer has been modified. 



Buffer Operations 

Gets a file into a buffer for editing. 

Selects a different buffer (prompts; default is the last one). 

Displays a menu of available buffers; lines are mouse-sensitive. 

Kills a buffer (prompts; default is current buffer). 

Moves to the beginning of the current buffer. 

Moves to the end of the current buffer. 

Selects the most recently selected buffer in this window. 



Character Operations 

c-B Moves left (back) a character. 

c-F Moves right (forward) a character. 

RUBOUT Deletes a character left. 

c-D Deletes a character right. 

c-T Transposes the two characters around point; if at the end of a 

line, transposes the two characters before point, ht -> th. 



Word Operations 

n-B Moves left (back) a word. 

n-F Moves right (forward) a word. 

n-RUBOUT Kills a word left (c-Y yanks it back at point). 

n-D Kills a word right (c-Y yanks it back at point). 

n-T Transposes the two words around point (if only 

only if). 
n-C Capitalizes the word following point. 

n-L Lowercases the word following point. 

n-U Uppercases the word following point. 



Line Operations 



c-H 


c-F 


c-K 


B 


c-K 


c-B 


c-K 


K 


n-< 




n-> 
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c-R Moves to the beginning of the line. 

c-E Moves to the end of the line. 

c-N Moves down (next) a line. 

c-0 Opens up a line for typing. 

c-P Moves up (previous) a line. 

c-K c-0 Closes up any blank lines around point. 

CLERR INPUT Kills from the beginning of the line to point (c-Y yanks it back at 

point). 
c-K Kills from point to the end of the line (c-Y yanks it back at 

point). 



Sentence Operations 

n-R Moves to the beginning of the sentence. 

n-E Moves to the end of the sentence. 

c-K RUBOUT Kills from the beginning of the sentence to point (c-Y yanks it 

back at point). 
m-K Kills from point to the end of the sentence (c-Y yanks it back at 

point). 



Paragraph Operations 

n- [ Moves to the beginning of the paragraph. 

n-] Moves to the end of the paragraph. 

n-Q Fills the current paragraph (see HELP R Ruto fill). 

n c-K F Sets the fill column to n (example: c-6 c-5 c-K F). 



Screen Operations 

SCROLL or c-U Shows next screen. 
n-SCROLL or n-U Shows previous screen. 

c-0 c-L Moves the line where point is to the top of the screen. 

c-n-R Repositions the window to display all of the current definition, if 

possible. 



Region Operations 

c-SPRCE Sets the mark, a delimiter of a region. Move the cursor from 

mark to create a region. The region is highlighted. Use with c-W, 
n-W, c-Y and region commands, for example, n-K Hardcopy Re- 
gion. 

c-W Kills region (c-Y yanks it back at point). 

n-W Copies region onto kill ring without deleting it from buffer (c-Y 

yanks it back at point). 

c-Y Yanks back the last thing killed. 



Window Operations 



Page 2568 



c-K 2 Splits the screen into two windows, using the current buffer and 

the previously selected buffer (the one that c-m-L would select). 

c-K 1 Resumes single window, using the current buffer. 

c-K Moves cursor to other window. 

c-n-U Shows next screen of the buffer in the other window; with a nu- 

meric argument, scrolls that number of lines — positive for the 
forward direction, negative for the reverse direction. 

c-K 4 Splits the screen into two windows and asks what to show in the 

other window. 



Search and Replace 

c-S string "Incremental" search; searches while you are entering the string; 

terminate search with END. 

c-R string "Incremental" backward search; terminate search with END. 

c-S END Enter String Search. See the section "String Search". 

c-7. stringl RETURN string2 RETURN 

Replaces stringl with string2 throughout. 

r\-Z stringl RETURN string2 RETURN 

Replaces stringl with string2 throughout, querying for each occur- 
rence of stringl; press SPRCE meaning "do it", RUBOUT meaning 
"skip", or HELP to see all options; (see HELP C n-Z). 



Summary of Help Functions in Zmacs and Lisp 

Both Zmacs and Lisp offer facilities for finding information either about them- 
selves or about the current environment. In addition, Zmacs offers ways to find in- 
formation about Lisp functions and variables. 

This section lists the names of the functions and commands that are available, 
grouped according to the context in which they are available. The purpose of this 
section is to summarize the capabilities and to help you determine both the overall 
contexts for which you can find help and a particular function that might be what 
you are looking for. 

See the section "Reference Description of Help Functions". 



Zmacs Commands for Finding Out About the State of Buffers 

Edit Changed Definitions (m-K) 

Edit Changed Definitions Of Buffer (n-H) 

List Buffers (c-K c-B) 

List Changed Definitions (m-K) 

List Changed Definitions Of Buffer (m-K) 

List Definitions (n-H) 

List Matching Lines (m-K) 

Print Modifications (m-K) 
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Zmacs Commands for Finding Out About the State of Zmacs 

Apropos (m-K) 

Describe Variable (m-K) 

Edit Zmacs Command (m-K) 

HELP L 

List Commands (m-K) 

List Registers (m-K) 

List Some Word Abbrevs (m-K) 

List Tag Tables (n-H) 

List Variables (m-K) 

List Word Abbrevs (n-H) 

Show Keyboard Macro (m-K) 



Zmacs Commands for Finding Out About Flavors 

Edit Combined Methods (n-K) 

Edit Methods (n-K) 

List Combined Methods (m-K) 

List Methods (n-K) 

Show Documentation Flavor (n-sh-F) 

Show Flavor Initializations (c-sh-F) 



Zmacs Commands for Finding Out About Tag Tables 

Compile Changed Definitions Of Tag Table (m-K) 

Find Files In Tag Table (n-K) 

List Tag Tables (n-H) 

Next File (n-K) 

Select All Buffers As Tag Table (n-H) 

Select Some Buffers As Tag Table (n-H) 

Select Some Files As Tag Table (n-H) 

Select System As Tag Table (n-K) 

Select System Version As Tag Table (n-K) 

Select Tag Table (n-H) 

Tags Edit Compare Differences (n-K) 

Tags Find Pattern (n-H) 

Tags Multiple Query Replace (n-K) 

Tags Multiple Query Replace From Buffer (n-K) 

Tags Query Replace (n-K) 

Tags Search (n-K) 

Tags Spell (n-H) 

Take Merge Choice (n-K) 

Visit Tag Table (n-H) 
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Zmacs Commands for Finding Out About Systems 

Edit Callers In System (n-H) 

Edit System Files (n-K) 

List Callers In System (m-K) 

Multiple Edit Callers In System (n-H) 

Multiple Edit Callers Intersection In System (m-K) 

Multiple List Callers In System (m-K) 

Multiple List Callers Intersection In System (m-K) 

Select System As Tag Table (n-K) 

Select System Change Buffer (m-K) 

Select System Version As Tag Table (n-K) 

Show All Section Changes Of System (m-K) 



Zmacs Commands for Finding Out About Lisp 

Describe Variable At Point (c-sh-U) 

Edit Callers (n-H) 

Edit Callers In Package (m-K) 

Edit Callers In System (n-H) 

Edit CP Command (n-K) 

Edit Definition (n-.) 

Edit File Warnings (m-K) 

Function Apropos (m-K) 

List Callers (n-K) 

List Matching Symbols (m-X) 

Long Documentation (c-sh-D) 

Multiple Edit Callers (n-K) 

Multiple List Callers (n-K) 

Quick Arglist (c-sh-R) 

Show Documentation (n-sh-D) 

Show Documentation Function (n-sh-R) 

Show Documentation Variable (n-sh-U) 

Where Is Symbol (n-K) 



Zmacs Commands for Interacting with Lisp 

Break (SUSPEND) 

Compile And Exit (n-Z) 

Compile Buffer (n-K) 

Compile Changed Definitions (n-K) 

Compile Changed Definitions Of Buffer (n-K), n-sh-C 

Compile File (n-K) 

Compile Region (n-K), c-sh-C 

Compiler Warnings (n-K) 

Edit Compiler Warnings (n-H) 
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Evaluate And Exit (c-n-Z) 

Evaluate And Replace Into Buffer (m-K) 

Evaluate Buffer (n-H) 

Evaluate Changed Definitions (m-K) 

Evaluate Changed Definitions Of Buffer (m-K), n-sh-E 

Evaluate Into Buffer (m-K) 

Evaluate Minibuffer (ESCRPE) 

Evaluate Region (m-K), c-sh-E 

Evaluate Region Hack (m-K) 

Evaluate Region Verbose (c-m-sh-E) 

Load Compiler Warnings (m-K) 

Macro Expand Expression (m-K), c-sh-M 

Quit (c-Z) 

Trace (n-K) 



Lisp Facilities for Finding Out About Lisp 

(zhapropos string package) 
(arglist function flag) 
(describe object) 
(describe-area area-name) 

(describe-defstruct instance structure-name) 
(describe-package package-name) 
(describe-system system-name) 
(disassemble function) 
(documentation function) 

(flavor:flavor-allowed-init-keywords flavor-name) 
(inspect object) 

(compilerrload-compiler-warnings file flush-flag) 
(mexp) 

(trace specs) 
(untrace specs) 
(variable-boundp variable) 
(what-files-call symbol-or-symbols how) 
(where-is pname) 
(who-calls symbol how) 



Dictionary of Command Processor Commands 

These commands can be typed in most Command Processor contexts. Those preced- 
ed by a colon (:) are available only in the Debugger. The accelerators for Debugger 
Commands are also given. 



Add Commands 
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Add HackSaw Command 

Add HackSaw pathname 



pathname 



The file to which to add the HackSaw. The default is a file for 
site-wide extensions. 



Lets anybody add an interesting fact to a file of interesting facts. You can use this 
command to create your own personal file of facts. 



Add Paging File Command 

Add Paging File pathname iprepend 

Enables you to add a paging file at the Command Processor prompt (in Lisp), 
rather than from within the FEP. If the paging file does not already exist, use the 
Create FEP File command to create it. See the section "Create FEP File 
Command". 



pathname 



keywords 
:Prepend 



The pathname of the existing FEP file, which becomes the new 
paging file. The default pathname is the disk unit from which 
you most recently booted. For example, if you most recently 
booted from FEP1:>, the default paging file might look like: 

FEP1 :>.page 

Each paging file must have a unique name. 

:Prepend 

{Yes, No} Yes puts the added paging file at the beginning of 
the list of existing paging files. This makes the newly added 
paging file available for immediate use. No (the default) puts 
the added paging file at the end of the list of existing paging 
files, so that it won't be used immediately. 



Add Services to Hosts Command 

Add Services to Hosts service-triples specific-hosts-or-all-hosts keywords 

Adds the specified service attributes in the namespace for one or more hosts. 

service-triples A service triple consists of a service, a medium, and a protocol. 

For more information, see the section "Concepts of Service, 
Medium, and Protocol". 

specific-hosts-or-all A list of hosts (or "all") to which you want to add services. If 
you specify all, use the :Namespace, :Site, and :Type keywords. 

Keywords: 



:Locally 



:Verbose 
:Namespace 

:Site 

:Type 
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{Yes, No} The initial default is No, which updates the global 
namespace database (the namespace server) to reflect the 
changes you have made. Answer Yes to update only the local 
Lisp world with the changes you have made; the changes will 
be "forgotten" when you cold boot the local machine (unless 
you save the changed world). 

The default for this keyword is displayed along with the ob- 
ject's name, and, if you are editing multiple objects in the 
Namespace Editor, the current setting becomes the default for 
subsequent objects. 

Prints messages for each host modified. 

Adds the services to all hosts in the namespace (use with the 
"all" argument). 

Adds the service to all hosts in the site (use with the "all" ar- 
gument). 

Adds the service to all hosts of this system type (use with the 
"all" argument). 



Here is an example adding netboot service to three hosts at once: 

Command: Add Services To Hosts (A Service Triple) (service) netboot 
(medium) slap (protocol) netboot 

(A sequence of hosts or All) HARPAGORNIS, WINTER, TOWHEE 
(keywords) : Locally 

Adding service NETBOOT SLAP NETBOOT to hosts (locally). 
Done. 



Append Commands 

Append Command 

Append (sources) source-type-and-name (forming) target-type-and-name 

Appends a selected source, which can be a file, an editor buffer, a stream, or a 
window, to a selected target, which can also be a file, an editor buffer, a stream, 
or a window. 



source-type-and-name 



Type in Buffer, File, Stream, or Window and then identify the 
particular buffer, file, stream, or window you wish to add to 
the target. The default is presented for File and Window. In 
all cases, a brief description of the target type appears. The 
source is unchanged by the Append operation. 
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target-type-and-name 



Boot Commands 



Type in Buffer, File, Stream, Printer, or Window and then 
identify the particular buffer, file, stream, printer, or window 
you wish to be the target. The default is presented for File 
and Window. In all cases, a brief description of the target type 
appears. The target is changed by the Append operation. 



Boot Machine Command 



Boot Machine boot-file keywords 

Boots the machine, using the specified boot-file. 



boot-file 



keywords 
:Delay 

:Logout 



:Reason 
: Simulate 



{filename, default} The name of the boot file to use. If no file 
is specified, or if default is specified, it uses whatever the cur- 
rent default boot file is in the FEP. Boot Machine verifies that 
the boot file exists and notifies you if it does not before halt- 
ing the machine. 

:Delay, :Logout, :Reason, :Simulate. 

{time-interval} An interval to wait before halting and rebooting 
the machine. The default is to proceed immediately if there are 
no active servers on your machine. If your machine has active 
servers, the default is to delay five minutes. 

{Yes, No} Whether to log you out before halting the machine. 
The default is Yes, to log you out. Note that even if you do not 
logout (that is, use :Logout No) your machine is still shut 
down cleanly, because Boot Machine knows that you are halt- 
ing the machine to cold boot it, unlike the Halt Machine com- 
mand, which cannot make that assumption since you might 
want to Continue or to warm boot. 

{string} The reason for the boot. 

{Yes, No} Whether to just show the effect of the command, 
without actually booting the machine. The default is No, the 
mentioned default is Yes. 



Boot Machine warns you of any open files and asks you for confirmation that you 
really want to halt your machine and reboot it. 



Clean Commands 
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Clean Directory Command 

Clean Directory pathname keywords 

Deletes and expunges all but a specified number of versions of a file in the speci- 
fied directory. 

pathname Pathname of the file whose excess versions you wish to clean 

up. A default is presented. Wildcards are accepted. To clean an 
entire directory, use the default *.*.*. To clean a smaller set of 
files use a more restrictive wildcard. 

keywords :Expunge, :Keep Versions, :More Processing, :Output Destina- 

tion, : Query Each 

:Expunge {Yes, No, Ask}. If you specify this keyword, Yes expunges the 

directory without asking, No does nothing, and Ask queries you 
as to whether to expunge the directory. The default is Ask. 

:Keep Versions {integer} This specifies the number of versions to keep. The 
default is the value of zwei:*file-versions-kept*, which is 2 by 
default. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Query Each {Yes, No} If you answer Yes, you are informed of the files that 

are to be kept and deleted and asked to confirm. If you con- 
firm, then you are asked if you want to expunge the directory. 
If you answer No, you are told which files are being kept or 
deleted and then asked if you want to expunge the directory. 
The default is Yes. 



Clean File Command 

Clean File pathname keywords 
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Deletes and expunges all but a specified number of versions of a file. This is simi- 
lar to Reap Files (m-K) or purging files on other systems. 

pathname Pathname of the file whose excess versions you wish to clean 

up. A default is presented. Wildcards are accepted. To clean an 
entire directory, specify 



;£ ;£ ;;< 



keywords :Expunge, :Keep Versions, :More Processing, :Output Destina- 

tion, : Query Each 

:Expunge {Yes, No, Ask}. If you specify this keyword, Yes expunges the 

directory without asking, No does nothing, and Ask queries you 
as to whether to expunge the directory. The default is Ask. 

:Keep Versions {integer} This specifies the number of versions to keep. The 
default is the value of zwei:*file-versions-kept*, which is 2 by 
default. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Query Each {Yes, No} If you answer Yes, you are informed of the files that 

are to be kept and deleted and asked to confirm. If you con- 
firm, then you are asked if you want to expunge the directory. 
If you answer No, you are told which files are being kept or 
deleted and then asked if you want to expunge the directory. 
The default is Yes. 



Clear Commands 

Clear All Breakpoints Command 

: Clear All Breakpoints compiled-function-spec 

Clears all breakpoints in the current frame's function or in any other compiled 
function. 
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compiled-function-spec 

The name of a compiled function in which you want to clear 
breakpoints. (Default clears all breakpoints in the current 
frame's function.) 



Clear Breakpoint Command 

: Clear Breakpoint compiled-function pc 

Clears a breakpoint. 

compiled-function The name of a compiled function in which you want to clear a 
breakpoint. 

pc The PC (program counter) at which you want to clear a break- 

point. The default is 1. 

Suggested mouse operations 

• To clear a breakpoint in a compiled function: Display disassembled code with 
the :Show Compiled Code command, point the mouse at a PC, and press 
c-n-Middle. 

• To clear a breakpoint in a code fragment: Display the code with the :Show 
Source Code command, point the mouse at a code fragment, and press c-n-Mid- 
dle. 

Clear Output History Command 

Clear Output History dynamic-window keywords 

Discards the history for the specified dynamic window. This is useful for when you 
want to clean up and do an incremental garbage collection. 

dynamic-window The window whose history to clear. The default is the current 
window. 

keywords :Keep All Text, :Keep Marked Text, :Keep Screenfuls. 

:Keep All Text {Yes, No} Remove presentations and graphics, but not charac- 

ters. The default is No, the mentioned default is Yes. 

:Keep Marked Text {Yes, No} Do not remove anything that is underlined. The de- 
fault is Yes. 

:Keep Screenfuls {integer} Do not remove anything within the last integer 
screenfuls. The default is 0, the mentioned default is 5. 
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Clear Sage Variable Command 

No documentation available for section Clear Sage Variable Command. 

Close Commands 



Close File Command 

Close File file-spec keywords 

Closes the specified open files or streams. 

file-spec The pathname of the open file, or the token All. If a pathname 

is specified, it should be the pathname of an open file. The de- 
fault is All. If All is specified, the function fs:close-all-files is 
executed. 

keywords :Mode, :More Processing, :Output Destination, :Query Each 

:Mode {Abort, Normal} The mode in which to perform the close oper- 

ation. The default is Abort. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} En- 
ables you to direct your output. The default is the stream 
*standard-output*. Note that redirecting output to a printer 
can be particularly useful. 

:Query Each {Yes, No} Whether to ask for confirmation before closing each 

file. The default is Yes. 



Compare Commands 

Compare Directories Command 

Compare Directories pathnamel pathname2 keywords 
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Compares the two specified directories. This command compares only filenames, 
not the contents of the files in the directories. If the directories contain the same 
information, you are notified that there are no differences in the two directories. If 
there are differences, two lists are printed. The first list contains the names of all 
the files in the first directory that are not in the second directory. The second list 
contains the names of all the files in the second directory that are not in the first 
directory. 

pathnamel The pathname of the first directory to be used in the compari- 

son. The default is the usual pathname default. 

pathname2 The pathname of the second directory to be used in the com- 

parison. The default is the usual pathname default. 

keywords :Ignore Versions, :More Processing, :Output Destination 

:Ignore Versions {Yes or No} The default is No. If Yes, then consider files with 
the same name and type to be the same even if they have dif- 
ferent version numbers. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Compile Commands 

Compile File Command 

Compile File pathname keywords 

Compile the file(s) designated in pathname. 

pathname The pathname of the file to compile. The default is the usual 

file default. 

keywords :Binary File, :Compiler, :Load, :More Processing, :Output Desti- 

nation, : Query, : Silently 
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:Binary File {pathname} The file into which to put the output. The default 

is pathname. .bin for a 3600-family machine, and pathname. ibin 
for an Ivory-based machine. 

:Compiler {Lisp, Pascal, Prolog, Fortran, Use-Canonical-Type} The com- 

piler to use. The default is Use-Canonical-Type. 

:Load {Yes, No, Ask} Whether to load the file after compiling. The 

default is No. The mentioned default is Yes. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



: Silently 



: Query 



{Yes, No} Whether to display the pathname of the file being 
compiled. The default is Yes. 

{Yes, No, Ask} Whether to ask for confirmation before compil- 
ing each file. The default is No. The mentioned default is Yes. 



Compile System Command 
Compile System system keywords 
Compile the files that make up system 
system 



keywords 



:Batch 



The name of the system to compile. The default is the last sys- 
tem loaded. 

Batch, : Component Version, : Condition, 

Copy Compile, :Include Components, :Load, :More Processing, 
New Major Version, :Output Destination, :Query, :Redefini- 
tions Ok :Silent, :Simulate, :Update Directory , :Version 

{Yes, No} Whether to save the compiler warnings in a file in- 
stead of printing them on the screen. The default is No, to 
print them on the screen. The mentioned default is Yes. 



: Component Version 

{version-designator} The version of any component system to 
load for the compilation. The default is Released. 
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:Condition {Always, New-Source} Under what conditions to compile each 

file in the system. Always means compile each file. New-source 
means compile a file only if it has been changed since the last 
compilation. The default is New-Source. 

:Copy Compile {Yes, No, Query} For those systems where the product of the 
compilation is not a true binary file (notably documentation 
systems) and is usable on both Ivory and 3600 architectures, 
:Copy Compile Yes has the effect of compiling it for the other 
architecture. For example, if you compile a documentation sys- 
tem on a 3600-family machine, to "copy compile" it would have 
the effect of compiling it for the Ivory architecture as well. 
Yes does the copy compile. No does not. Query prints an expla- 
nation of what is being offered, and queries about whether to 
do it. The copy compile works by copying the form in the com- 
ponent-di r. 

: Include Components 

{Yes, No} Whether to load any component systems. The default 
is Yes. If :Include Components is Yes, :Component Version is 
used to select the appropriate version of any component sys- 
tems. 

:Load {Everything, Newly-Compiled, Only-For-Dependencies, Nothing} 

Whether to load the system you have just compiled into the 
world. The default is Newly-Compiled. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:New Major Version 

{Yes, No} Whether to give your newly compiled version of the 
system the next higher version number. The default is Yes. 
Giving the choice No will ask you to confirm that you really 
want to "prevent incrementing system major version number". 
(Note that if your goal is to compile a system version for an- 
other machine type, you should use the Version keyword, in- 
stead of specifying :New Major Version No. For more informa- 
tion, see the section "Compiling a System for Multiple Machine 
Types".) 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 
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:Query {Everything, Yes, Confirm-Only, No} Whether to query before 

compiling. Everything means query before compiling each file. 
Confirm-Only means create a list of all the files to be compiled 
and then ask for confirmation before proceeding. No means 
just go ahead and compile the system without asking any 
questions. The default is No. The mentioned default is Every- 
thing. 

:Redefinitions Ok {Yes, No} Controls what happens if the system asks for confir- 
mation of any redefinition warnings during the compilation. 
Yes means assume that all requests for confirmation are an- 
swered yes and proceed. No means pause at each redefinition 
and await confirmation. The default is No. The mentioned de- 
fault is Yes. This allows you to start a compilation that you 
know will take a long time and leave it to finish by itself with- 
out interruption for questions such as "Warning: function-name 
being redefined, ok? (Y or N)". 

:Silent {Yes, No} Whether to suppress output to the screen. The de- 

fault is No, to allow output. The mentioned default is Yes. 

:Simulate {Yes, No} Print a simulation of what compiling would do. The 

default is No. The mentioned default is Yes. 

:Update Directory 

{Yes, No, version-designator} Whether to update the directory 
of the system's components. The default is Yes. 

:Version {Newest, version-number} Specifies the version number of a 

system. When this option is used, SCT checks the journals for 
the specified system and compiles a new version of the system 
using the same version of the source files. The new system 
must be compiled for a different machine type. See the section 
"Compiling a System for Multiple Machine Types". The default 
is Newest. 



Compress Commands 

Compress File Command 

Compress File input-files output-files keywords 

Compresses the data in input-files and produces output- files . Wildcards are allowed. 
If input-files and output-files are the same files, the input files are replaced by the 
output files. 

input- files {pathname(s)} One or more files to compress. 
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output-files {pathname(s)} One or more files to contain the compressed da- 

ta. 

keywords :Copy Properties, :Create Directories, :More Processing, :Out- 

put Destination :Preamble Type, :Query, :Translation Strategy 

:Copy Properties {list of file properties} The properties you want duplicated in 
the new files. The default is author and creation date. 

:Create Directories 

{Yes, Error, Query} What to do if the destination directory 
does not exist. The default is Query. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Preamble Type {Symbolics, UNIX} Type of preamble to use. 

:Query {Yes, No, Ask} Whether to ask before compressing each file. 

: Translation Strategy 

{Text, Binary, Query, Heuristicate } Whether or not to perform 
character set translation. Text means to do ASCII character set 
translation, reading each input file as a text file. Binary means 
not to do ASCII character set translation, reading each input 
file as a binary file. Query asks, for each file, whether to treat 
the file as text or binary. Heuristicate attempts to guess 
whether the file is text or binary based on its name, as fol- 
lows: The filename is broken up into words, where each word 
is separated by a non-alphanumeric character. A rightmost 
word of "Z" is removed (if present). Then the current right- 
most word is checked against compression: :*likely-unix- 
binary-formats* If a match is found, the file is assumed to be 
binary, otherwise it is assumed to be text. 

: Translation Strategy is only useful if you are reading or writ- 
ing a file with a UNIX-style compression preamble, because 
Symbolics-style compression preambles record the element type 
and character set of the compressed data. Using :Translation 
Strategy with a file having a Symbolics-style compression 
preamble is ignored with a warning. 
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Copy Commands 

Copy File Command 

Copy File pathname (to) destination-spec keywords 

Makes a copy of a file. 

pathname The pathname of the file you want to copy. 

destination-spec The pathname of the location you want to put the copy of the 
file. 

keywords :Byte Size, :Copy Properties, :Create Directories, :Mode, :More 

Processing, :Output Destination, :Query 

:Byte Size {integer} Byte size in which to do the copy operation. 

:Copy Properties {list of file properties} The properties you want duplicated in 
the new file. The default is author and creation-date. 

:Create Directories 

{Yes, Error, Query} What to do if the destination directory 
does not exist. The default is Query. 

:Mode {Character, Binary, Default, Macintosh, Raw Character} The 

mode in which to perform the transfer. The default is Default. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Query {Yes, No, Ask} Whether to ask for confirmation before copying 

each file. The default is No. The mentioned default is Yes. 

Copy Flod Files Command 

Copy Flod Files keywords 

Copies FEP overlay (flod) files to a Symbolics 3600-family machine, or flod files 
and a FEP kernel to to an Ivory-based machine. On Ivory-based machines, Copy 
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Flod Files also makes sure that your FEP kernel and overlay versions are consis- 
tent with one another, and installs the previous FEP kernel as the FEP backup 
kernel. On XL1200 Color Systems, Copy Flod Files also copies the color system 
startup file. We recommend that you do not delete previous versions of the flod 
files and FEP kernel, because they can be useful in debugging certain problems. 



keywords 



Automatic 



Automatic, :Create Hello File, :Disk Unit, :From Directory, 
:Hosts, :Silent, :Version 

Whether to automatically skip copying the flod files to any 
hosts for which the process gets an error. The default is Yes if 
more than one target host is specified, otherwise No. The men- 
tioned default in both cases is Yes. 



: Create Hello File 



:Disk Unit 



{Yes, No, Ask} Whether or not to create a Hello. boot file after 
copying (if one does not already exist). The default is Ask. 

{integer} Disk onto which flod files will be copied. The default 
is 0. 



:From Directory {pathname} Directory from which to copy files. On Symbolics 
3600-family machines, the default is syS:N-fep; . On Ivory-based 
machines, the default is SYS:iFEP; . 



:Hosts 

: Silent 
:Version 



{name, All} Host(s) to which flod files will be copied. The de- 
fault is your local FEP. 

{Yes, No} Display files as they are copied. The default is Yes. 

FEP version. For example, G206, G208, V127, or 1316. 



Copy Microcode Command 

Note: This command is implemented only on Symbolics 3600-family machines. 

Copy Microcode (version or pathname} destination keywords 

Installs a version of microcode. 



version or pathname 



destination 



Microcode version number or pathname to copy, version is a 
microcode version number (in decimal), pathname rarely needs 
to be supplied. It defaults to a file on FEPn:> (where n is unit 
number of the boot disk) whose name is based on the mi- 
crocode name and version. (The file resides in the logical di- 
rectory SYS:L-UC0DE;.) The version actually stands for the file 
appropriate-hardware-MICMIC.version on FEPn:>. 

FEP file specification. The pathname on your FEPn:> directo- 
ry. The default is created from the microcode version. 
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keywords :Update Boot File 

:Update Boot File 



{FEP- file-spec, None, Query}. The pathname of the boot file 
you want it to update. The default is the current default boot 
file name. 



Copy Output History Command 

Copy Output History destination 

destination {Buffer, File, Kill Ring, Printer, Stream, Window} Where to 

put the copy of the history. 

Copies the history of your interaction with a Lisp Listener to destination. This is 
useful if you want to edit your interaction for saving as a text file or if you want 
a hardcopy of it. 

Copy World Command 

Copy World file destination keywords 

Makes a copy of file (by default, a world load). This includes the specified world as 
well as any Incremental Disk Save (IDS) worlds on which it was built. See the sec- 
tion "Using the Incremental Disk Save (IDS) Facility". Copy World works from re- 
mote terminals. Copy World can also be used to copy netboot cores. You can boot a 
world from a remote world server with only a netboot core on your FEP. See the 
section "Netbooting". 

file A FEP file specification; the world to copy. The default is con- 

structed from the version of the world that you have booted. 

destination A FEP file specification; the pathname for the new world. The 

default is a wildcard pathname assuring the correct hierarchi- 
cal pathname relationship for the parent world and an IDS 
world. 

Note: The . i 1 od file extension indicates world-load files for Ivory-based machines, 
just as the . 1 oad file extension indicates world-load files for Symbolics 3600-family 
machines. Files with the . i 1 od extension can be copied only between Ivory-based 
machines. Files with the . 1 oad extension can be copied only between Symbolics 
3600-series machines. 

After you issue the Copy World Command, Genera puts up a menu allowing you to 
specify the actions you want it to take: 

keywords Automatic, :End Block, :File Set, :More Processing, :Output 

Destination, :Query, :Start Block, :Transfer Mode, :Update Boot 
File. 
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There are 43453 blocks total "in the files to be transferred. 
There are 339 blocks free on FEP1 . 
You need 39641 more blocks. 
Possible actions to make space right now: Run dired Expunge directory Selectively delete 

Parent IDS files to transfer: Rll parents Hissing parents Just requested files Selective 
Update boot file to load FEP1 : >Base-Systen-372-0 . 1 oad . 1 : Yes No 

Boot file to update: FEP0 : >boot . boot . newest 

Update FEP3 : >boot . boot . newest to load Microcode 410: Yes Mo 
Transfer node: Transfei — Rnd-Checksun Transfer-Only Checksun-Onl y 
flttenpt automatic error recovery: Yes Mo 
<reqrt> aborts^ <1EI> uses these values 



Figure 124. Copy World 



Automatic {Yes, No} Whether or not to attempt automatic error recovery. 

The default is Yes. 

:End Block {integer} The number of the last block to copy from source. 

The default is the last block, meaning copy until the end. 

:File Set {All parents, Missing parents, Just Requested Files, Selective} 

Which parent IDS files to transfer. The default is Missing par- 
ents. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



: Query 



{Yes, No} Whether or not to present a menu of transfer pa- 
rameters. The default is Yes. 



:Show Blocks Copied 

{Yes, No} Whether to print block numbers for blocks finished 
copying, every 100 blocks. The default is No, the mentioned de- 
fault is Yes. 



: Start Block 



: Transfer Mode 



{integer} The number of the block to start copying from the 
source. The default is 0, meaning begin at the beginning. 

{ Transfer-and-Checksum, Transfer-Only, Checksum-Only} 
Whether to verify the integrity of the copied world. The de- 
fault is Transfer-and-Checksum. You can use Checksum-Only to 
checksum a band that you copied previously but were unable to 
checksum due to network problems. 
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:Update Boot file {FEP- file-spec, none}. Boot file to update to load the new 
world. The default boot file for IDS or complete worlds is 
boot. boot. The default for netboot cores is none. 



Create Commands 

Create Directory Command 

Create Directory pathname 

Creates a directory for storage of files on a file system specified in pathname. 

pathname The pathname of the directory to be created. 

Create FEP File Command 

Create FEP File FEP-file-spec size 

Creates a file on a FEP directory on your machine. 

FEP-file-spec The pathname of the file to create. The default is 

FEP:>temporary.temp. 

size The size in FEP blocks of the file. You must supply this. 

Use Create FEP File to do the following: 

• To create an extra paging file. For example: 

Create FEP File fep0:>aux.page 100000 

• To allocate space into which to load a world load. For example: 

Create FEP File fep0:>release-8-0. load 50000 

Create File Command 

Create File pathname 

Uses the Simple editor (see the section "Edit File Command") to create a new file 
or to supersede a file that exists already. 

pathname The pathname of the file to be created. 
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Create Initial FEP Filesystem Command 

Create Initial FEP Filesystem FEP-unit 

Creates an initial FEP filesystem on the given FEP-unit. This command is used 
for initializing an optical disk or a SCSI disk. 

FEP-unit The number of the FEP unit. 

The convention for mapping SCSI addresses to FEP unit number is that the FEP 
unit number is 7 greater than the SCSI address. For example, if you set up the 
SCSI disk drive at SCSI address 4, the FEP unit is FEP 11. (Note that if you have 
multiple I/O boards, and the SCSI disk drive is attached to the second I/O board, 
then the FEP unit is 23 plus the SCSI address.) 

Create Link Command 

Create Link pathname target keywords 

Creates an association between one pathname and a second pathname, called the 
target. The first pathname is linked to the target so that any references to the 
first pathname actually refer to the target. 

pathname The pathname you want to link from. The default is the stan- 

dard file default. 

target The pathname you want to link to. This pathname must exist. 

There is no default. 

keywords :Create Directories, :More Processing, :Output Destination, 

:Type 

:Create Directories 

{Yes, Error, Query} What to do if the destination directory 
does not exist. The default is Query. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 
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:Type 



{Read-Only, Read-Write, Create-Through, All, or Use-Default} 
The kind of link to create. The default is Use-Default. 



Create Namespace Object Command 

Create Namespace Object class name keywords 

Adds a new object to the namespace database. For more information about adding 
objects to the namespace database, see the section "Creating a New Namespace 
Object". 



class 



name 



Keywords 
:Copy From 



: Insert Defaults 



:Locally 



{File-System, Host, Namespace, Network, Printer, Site, User} 
The type of object you want to create. 

The name of the new object. 

:Copy From, :Insert Defaults, :Locally, :Property-List 

{name of an object of the same class} This will copy the con- 
tents of the object named into the newly created object. Dupli- 
cate names are removed before the contents are inserted into 
the new object to avoid conflicts. 

Toggles the Namespace Editor insert-defaults mode on or off 
for the current namespace object. The initial mode is off. 

When the insert-defaults mode is enabled for an object, the 
Namespace Editor inserts default values to the following indi- 
cators: 

File Control Lifetime 

Home Host 

Lispm Name 

Mail Address 

Pretty-Name 

Printer and Bitmap Printer 

Printer Interface 

Services 

Site 

See the section "The Insert Defaults Namespace Editor Com- 
mand" for details on how default values are derived. 

{Yes, No} The initial default is No, which updates the global 
namespace database (the namespace server) to reflect the 
changes you have made. Answer Yes to update only the local 
Lisp world with the changes you have made; the changes will 
be "forgotten" when you cold boot the local machine (unless 
you save the changed world). 

The default for this keyword is displayed along with the ob- 
ject's name, and, if you are editing multiple objects in the 
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Namespace Editor, the current setting becomes the default for 
subsequent objects. 

:Property List {a Lisp expression} This specifies an initial property list for 

the newly created object in the internal form that object prop- 
erties are specified in. This keyword option will have no effect 
if the :Copy From keyword option is used. 



Create Netboot Core Command 

Create Netboot Core world 

Creates a netboot core, a small world with just enough information in it to be able 
to locate and boot a world over the net. An appropriate netboot core is included on 
every distribution tape, so you should never need to use this command. 

world {pathname} The pathname of a world load file to use to create 

the netboot core. This world must be resident on your FEP or 
IFEP. 



Create Spell Dictionary From Namespace command 

Create Spell Dictionary From Namespace namespace pathname 

Creates a Speller dictionary with all the user-names, first names, and last names 
from the list of User objects in the namespace. (For speed, the command works by 
accessing the files that hold the namespace database rather than by accessing the 
actual namespace servers.) 

namespace The namespace you wish the dictionary to represent. 

pathname The pathname of the binary dictionary file to be created. 

Once you have created the file, use the namespace editor to make it a site-specific 
dictionary. See the section "Adding Site-specific Speller Dictionaries". 

Debug Commands 

Debug Process Command 

Debug Process process 

Enters the Debugger to look at process. 

process A process. You can press HELP for a list of all the processes 

currently running in your environment. See the section "Show 
Processes Command". 
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Decompress Commands 

Decompress File Command 

Decompress File input-files output-files keywords 

Decompresses the data in input-files and produces output- files . Wildcards are al- 
lowed. If input-files and output-files are the same files, the input files are replaced 
by the output files. 

input- files {pathname(s)} One or more files to decompress. 

output-files {pathname(s)} One or more files to contain the decompressed 

data. 

keywords :Copy Properties, :Create Directories, :More Processing, :Out- 

put Destination :Preamble Type, :Query, :Translation Strategy 

:Copy Properties {list of file properties} The properties you want duplicated in 
the new files. The default is author and creation-date. 

:Create Directories 

{Yes, Error, Query} What to do if the destination directory 
does not exist. The default is Query. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Query {Yes, No, Ask} Whether to ask before decompressing each file. 

: Translation Strategy 

{Text, Binary, Query, Heuristicate } Whether or not to perform 
character set translation. Text means to do ASCII character set 
translation, writing each resulting file as a text file. Binary 
means not to do ASCII character set translation, writing each 
resulting file as a binary file. Query asks, for each file, 
whether to treat the file as text or binary. Heuristicate at- 
tempts to guess whether the file is text or binary based on its 
name, as follows: The filename is broken up into words, where 
each word is separated by a non-alphanumeric character. A 
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rightmost word of "Z" is removed (if present). Then the cur- 
rent rightmost word is checked against compression: :*likely- 
unix-binary-formats*, and if a match is found, the file is as- 
sumed to be binary, else it is assumed to be text. 

: Translation Strategy is only useful if you are reading or writ- 
ing a file with a UNIX-style compression preamble, because 
Symbolics-style compression preambles record the element type 
and character set of the compressed data. Using :Translation 
Strategy with a file having a Symbolics-style compression 
preamble is ignored with a warning. 



Define Commands 

Define Site Command 
Define Site site-name 

Defines a new site. 

Type the Define Site command immediately after you boot a new distribution world 
when you want to define a new site and namespace; it brings up a menu to create 
a new namespace called site-name; when you start this dialogue the local host is, 
by default, the site's: 

• Primary namespace server. 

• SYS host. 

• Host for storing namespace database files. 

• Host for bug reports. 

If you want non-local host(s) to perform any of these jobs, provide their primary 
network addresses and operating system types in the appropriate menu slots. 

During the Define Site dialogue, the namespace database files (object files, log 
files, changes files, and a descriptor file) are created for you on the file system of 
the machine you specify as the namespace server. Make sure the file system exists 
on a host accessible to the namespace server machine before you issue the Define 
Site command. For more information about the namespace database files, see the 
section "Namespace Database Files". 

The namespace server for the new site will have these initial default attributes 
when the Define Site command is used (nnnnn represents a valid octal Chaos ad- 
dress): 
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System Type*: LISPM 

Machine Type: 3600 

Service: CHAOS-STATUS CHAOS-SIMPLE CHAOS-STATUS 

Service: SHOW-USERS CHAOS NAME 

Service: TIME CHAOS-SIMPLE TIME-SIMPLE 

Service: UPTIME CHAOS-SIMPLE UPTIME-SIMPLE 

Service: LOGIN CHAOS TELNET 

Service: LOGIN CHAOS SUPDUP 

Service: LOGIN CHAOS 3600-LOGIN 

Service: SEND CHAOS CONVERSE 

Service: SEND CHAOS SEND 

Service: NAMESPACE CHAOS NAMESPACE 

Service: NAMESPACE-TIMESTAMP CHAOS-SIMPLE NAMESPACE-TIMESTAMP 

Service: LISPM-FINGER CHAOS-SIMPLE LISPM-FINGER 

Service: FILE CHAOS NFILE 

Service: FILE CHAOS QFILE 

Service: CONFIGURATION CHAOS CONFIGURATION 

Address: CHAOS 12345 

See the section "Define Site Dialogue". 



Delete Commands 



Delete Directory Command 

Delete Directory pathname keywords 

Deletes and expunges the directory represented by pathname. 



pathname 



The physical name of the directory to delete. (Using a logical 
pathname could result in an ambiguous directory reference.) 
Delete Directory asks you to confirm the deletion before doing 
it. 

You should make sure that pathname represents a directory. 
A:>KJones>projects> is a directory, and 

Delete Directory A:>KJones>projects> 

offers to delete the projects subdirectory. However, 

Delete Directory A:>KJones>projects 

is a file name whose directory component is >KJones>; it 
therefore offers to delete the directory KJones. Similarly, the 
pathname 

A:>KJones>projects.di rectory 

is a file representation of a directory. It is not the directory 
name for use with commands that manipulate files in directo- 
ries, so giving it as an argument to Delete Directory also of- 
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fers to delete the directory KJones. 

keywords : Confirm 

:Confirm {Yes, No, Each} Whether to ask before deleting each subdirec- 

tory. The default is Yes. The mentioned default is Each. 



Delete File Command 



Delete File pathname keywords 



Deletes or marks for deletion the file pathname. 

pathname Pathname of the file to delete. The default is the usual file 

default. The version defaults to newest. 

keywords :Expunge, :More Processing, :Output Destination, :Query 

:Expunge {Yes, No, Ask}. Whether to expunge the file. The default is 

No. The mentioned default is Yes. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Query {Yes, No, Ask} Whether to ask for confirmation before deleting 

the file. The default is No. The mentioned default is Yes. 



Delete Namespace Object Command 

Delete Namespace Object class name keywords 

Removes information about the object name from the namespace. 

class {File-System, Host, Namespace, Network, Printer, Site, User} 

The type of object you want to delete. 

name The name of the object you want to delete. 
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Keywords: :Locally 

:Locally {Yes, No} The initial default is No, which updates the global 

namespace database (the namespace server) to reflect the 
changes you have made. Answer Yes to update only the local 
Lisp world with the changes you have made; the changes will 
be "forgotten" when you cold boot the local machine (unless 
you save the changed world). The default for this keyword is 
displayed along with the object's name, and, if you are editing 
multiple objects in the Namespace Editor, the current setting 
becomes the default for subsequent objects. 

If the object you are deleting is still referenced by other objects, for example, if 
you are deleting a host and a user still lists that host as a mail address, you can- 
not delete it. This protects your namespace from becoming corrupted. You get an 
error telling you which objects still reference the object you are trying to delete so 
you can edit those objects to remove the references. 

Error: Error from Namespace on RIVERSIDE: You cannot delete HOST QUABBIN. 
It is still referenced by the following objects: 

SITE SCRC USER LISP-MACHINE USER WOBBLY 

USER SCH | FILE-SERVER USER DCP USER HASEGAWA 

USER NFEP USER FILE-SERVER 

USER NISHIMOTO USER ZIPPY 



Delete Printer Request Command 

Delete Printer Request printer-request 

Deletes the specified print request from the print queue. 



printer-request 



keywords 
: Confirm 



A string specifying the printer and the request you are delet- 
ing. You can select the print request with the mouse from the 
display of the Show Printer Status command. For more infor- 
mation, see the section "Show Printer Status Command". You 
can also specify the printer name to which you are sending re- 
quests and use "c-? and c-/"for displaying all requests. For 
more information, see the section "Completion in the Command 
Processor". 

: Confirm 

{Yes, No} Whether to request confirmation when you delete a 
request currently printing. The default is Yes. 



Disable Commands 
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Disable Capabilities Command 

Disable Capabilities host capabilities 

Turns off specified capabilities for host. 

host The name of the host on which you want to disable 

capabilities. 

capabilities The capabilities you want to disable on host. 

Disable Condition Tracing Command 

:Disable Condition Tracing c-K T 

Disables condition tracing. The c-K T accelerator toggles between :Disable Condi- 
tion Tracing and :Enable Condition Tracing. See the section "Enable Condition 
Tracing Command". 

Disable Network Command 

Disable Network network(s) 

Disconnects the local machine from the network. 

Network(s) {network, All} The network(s) from which to disconnect. The 

possibilities are the networks to which your machine is con- 
nected. The default is All, meaning disable all network service 
on your machine. 

Disable Services Command 

Disable Services service-type 

Turns off service(s) on the local machine. 

service-type {All-Services, servicel, service2...} The service to turn off. Press 

HELP for a list of available services. The default is All-services. 



Dismount Commands 

Dismount Optical Disk Command 

Dismount Optical Disk SCSI-address keywords 
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Dismounts the optical disk indicated by SCSI-address. Once the disk is dismount- 
ed, you cannot access it again until you mount it. 

SCSI-address The SCSI address of the optical disk drive. 

keywords :Eject 

:Eject {Yes, No} Whether to eject the optical disk after it is dis- 

mounted. The default is No. The mentioned default is Yes. 



Distribute Commands 

Distribute Systems Command 

Distribute Systems systems-and-versions-pairs keywords 

Writes systems to tape for distribution. If you do not specify a system, the Dis- 
tribute Systems Activity window is selected for you. Distribute Systems lists the 
systems to write to tape, and asks if you want to perform the Distribute Systems 
operation. Type Y for Yes, N for No, Q for Quit, or S for Selective. 

If you choose Selective, each file is listed, and you are asked if you want to dis- 
tribute that particular file. You can select as many files as you want. After you en- 
ter this information, you are prompted for a tape specification, if you did not speci- 
fy one already. 

systems-and-versions-pairs 

A list consisting of items separated by commas, each item be- 
ing a system name followed by a space and a version number. 

keywords :Compress Files, :Default Version, :Distribute Patch Sources, 

:File Types, :Full Length Tapes, :Include Components, :Include 
Patches, included Files Checkpoint, :Machine Types, :Menu, 
:More Processing, :Output Destination, :Query, :Source Catego- 
ry, :Tape Spec, :Use Cached Checkpoint, :Use Disk 

:Compress Files {Yes, No} Whether to compress the files when writing them to 
tape. The default is No. The mentioned default is Yes. 

:Default Version {Released, Latest, Newest, version-designator) Version of the 
system to distribute if not individually specified in Systems. 
The default is Released. 

:Distribute Patch Sources 

{Yes, No} Whether to include patch sources for system patch- 
es. The default is No. The mentioned default is Yes. 

:File Types {Sources, Binaries, Both, Patches-Only, Default} What file 

types to distribute. The default leaves it to the specifications 
in individual defsystem forms. 
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:Full Length Tapes 

{Yes, No} Write all tracks of the tape. Use this only if you are 
sure that you don't have to read the tape on a 3600 Cipher 
drive. The default is No. The mentioned default is Yes. 

: Include Components 

{Yes, No} Whether to include any component systems of the 
systems being distributed. The default is Yes. 

:Include Patches {Yes, No, Selective} Whether to include the patch files for the 
systems being distributed. The default is Yes. If you include 
patch files and also distribute source files, the source file cor- 
responding to the patch level, not necessarily the source used 
for the compilation, is the one included on the tape. For exam- 
ple, suppose you have a system that includes the file 
blue. lisp. 1. You put this file in an editor buffer, modify the 
code, make a patch file, and then save the buffer with the al- 
tered code to blue. lisp. 2. When you use Distribute Systems, 
blue. lisp. 2 is distributed, but not blue. lisp. 1. 

included Files Checkpoint 

{Patch, Release, None} Limit distributed files to those after 
this patch number or release name, or None (do not limit). 
The default is None. 

:Machine Types {3600, Imach, All} Specifies whether the systems to distribute 
should be for 3600-family machines, Ivory-based machines, or 
all machine types. The default is to distribute systems for all 
machine types. 

:Menu {Yes, No} Whether to use a menu interface to specify details 

of the distribution. Choosing Yes presents a Distribute Systems 
frame to select which files are distributed. For detailed infor- 
mation about this frame, see the section "Distribute Systems 
Activity". The default is No. The mentioned default is Yes. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Query {Everything, Yes, Confirm-Only, No} Whether to ask about dis- 

tributing each file. The default is Confirm-Only. The men- 
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tioned default is Everything. Everything queries you about 
each file being distributed, and again for each system being 
distributed. Yes queries you about each file being distributed. 
Confirm-Only queries you about each system being distributed. 
No does not query. 

For queries about individual files, the possible responses are: 

Y Yes, distribute this file. 

N No, do not distribute this file. 

I Include the remaining files in this system. 

B Bypass (do not include) the remaining files in this system. 

D Directory. Show the directory containing this file. 

E Edit this file. 

S Source compare this file. 

For queries about systems, the possible responses are: 

Y Yes, distribute all files listed in this system. 
N No, do not distribute any files listed. 

Q Quit. Do not distribute any files listed in this system. 

S Selective. Query about each file in this system individually. 

:Source Category {Basic, Optional, Restricted, Optional-only, Restricted-only} In- 
dicates which source category or categories to write to tape for 
distribution. The default is Basic. 

:Tape Spec The specification for the tape. The default is the default drive 

on the local machine. For more information about tape specifi- 
cations, see the section "Tape Specifications". 

:Use Cached Checkpoint 

{Yes, No} Use the last checkpoint gathered for this system. 
Using the cached checkpoint information, if there is any, saves 
time. But it is safe to use only if you are sure no more patches 
have been made since the cached information was computed. 
The default is No. The mentioned default is Yes. 

:Use Disk On all machines other than a Maclvory, the choices are {Yes, 

No}. If Yes, the input is written to disk as a special file that is 
an image of what would be written to tape. When writing to 
disk, the distribution plan is not divided into parts according to 
any size limit. You can use this either to distribute on disk, or 
when you are preparing a distribution and want to see what 
files would be written to tape. The default is No. The men- 
tioned default is Yes. 

On a Maclvory, the choices are {Tape, Disk, Floppy}. Disk indi- 
cates the hard disk, and Floppy indicates the floppy disk. These 
two values also write a special file that is an image of what 
would be written to tape. Additionally, when a floppy disk is 
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used, the size limit for a "reel" is set to the capacity of the 
floppy (that is, 800 Kbytes). Tape means to write to tape; this 
is the default. 



Edit Commands 



Edit ACL Command 

Edit ACL directory 

Starts up a small window, editing the Access Control List for directory. It is used 
to create, edit or remove access control lists for LMFS directories. This command 
can be executed from any console, by the owner of directory. This should be coordi- 
nated with the Site Administrator, so that passwords can be assigned and any new 
capabilities can be set up. See the section "Access Control Model: What You Can 
and Cannot Protect". 

The window is divided into four panes: the top displays the name of the directory, 
the next pane displays the existing ACLs, next is a command pane, and the bottom 
pane is a minibuffer for typein. 



Creating ACL of SAP:> 



Top 
WT-Project: read write append properties list supersede create owner 
visitors: rea d write append properties list supersede create owner 
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This is the LMFS directory Recess Control List (RCL) editor. It can be 
used to create, edit, or remove access control lists for remote or local 
Lisp Machine file systems. Click on [Edit] and enter the pathname of a 
directory whose RCL is to be edited, or on [ u iew] to look at it without 
editing it. Click "Mew RCL Entry" to add a new entry, and on the 
access name of an RCL entry to delete an entry. Click on individual 
modes to change them.J 
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Figure 125. Access Control List Editor 
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[Save] 
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[Copy] 

[Clear] 
[Revert] 

[Quit] 
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Display general information about the Access Control List edi- 
tor. 

Prompts for the name of a directory, and starts an edit of its 
ACL. If there is no ACL for that directory, the second pane 
will only contain New ACL entry. Click on this command to 
add a new ACL. To delete an entry, click on the access name 
of that entry. 

Each entry consists of an access name, and a list of modes 
that can be enabled or disabled. Clicking on a mode toggles 
whether or not it is enabled. Modes that are enabled appear in 
boldface type, and modes that are disabled appear in roman 
type. 

Installs the permissions for the host you are editing by chang- 
ing the file properties for that directory. 

Prompts for the name of a directory, and displays its ACL. 
This is done in read-only mode, so you cannot modify the ACL 
using this command. 

Creates a new ACL for a directory by copying the current 
ACL. 

Disables all modes for the current ACL entry. 

Reverts the ACL to the modes specified in the saved file for 
this directory. If the ACL has never been saved, the editor 
asks if you want to discard the current ACL information. When 
you confirm, all entries are discarded. 

Return from the Edit ACL command to whatever you were pre- 
viously doing. 



For the example here, the capability named "WT-Project" allows all operations on 
the directory SAP:>. The capability named "visitors" only allows the reading and 
listing of files in the directory. 



Edit Definition Command 

Edit Definition name type 

Finds the definition of type type for the object name and puts it in an editor buffer 
for you to edit. This is the same as the Zmacs command n-.. See the section "Edit 
Definition". 



name 
type 



Name of the object whose definition you want to edit. 

{Any,Function,locf function,zl:setf function} The type of defini- 
tion for the object. 
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Edit Directory Command 

Edit Directory directory-spec keywords 

Invokes the directory editor zhdired in Zmacs. See the section "Dired Mode in 
Zmacs". 

directory-spec Pathname of the directory to edit. The default is the usual file 

default. 

keywords :Version 

:Version {All, Newest, number] The versions of the file to be included 

in the directory listing. The default is All. 



Edit Disk Label Command 

Edit Disk Label unit-number 

Edits the disk label of the disk identified by unit-number. Brings up a menu of 
choices, which you can click on to change aspects of the disk label, such as the 
FEP kernel, backup FEP kernel, and the color system startup file (used for color 
systems). You can also click on choices to deinstall the current FEP kernel, dein- 
stall the FEP backup kernel, and deinstall the color system startup file. 

Just as the device PROM finds the FEP kernel by reading the disk label, it also 
needs to find the file where the FrameThrower color system startup programs are 
stored. Note that the device PROM does not understand the FEP file system; it 
just reads the disk label, which points to the correct file. 

unit-number {integer, All} The number identifying the FEP disk whose disk label 
you want to edit. All allows you to edit the labels of all the 
disks attached to the machine. 

Normally, the FEP kernel and FEP backup kernels are installed automatically, 
when you use the Copy Flod Files command. Copy Flod Files installs the new FEP 
kernel and installs the previous FEP kernel as the backup FEP kernel. Only in un- 
usual debugging circumstances do you need to deinstall the FEP kernel or FEP 
backup kernel by using Edit Disk Label. When you deinstall the FEP kernel, the 
FEP backup kernel is installed as the FEP kernel. When you deinstall the FEP 
backup kernel, the FEP kernel is installed as the FEP backup kernel. (Note that 
the FEP kernel and FEP backup kernel must always be present, in order for this 
to work properly.) Thus, when you deinstall either the FEP kernel or FEP backup 
kernel, the result is that a single FEP kernel is installed as the FEP kernel and 
the FEP backup kernel; in other words, there is no separate FEP backup kernel. 
When you next use Copy Flod Files, the new kernel will be installed as the FEP 
kernel, which means you will again have a different FEP kernel and FEP backup 
kernel. 
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Edit File Command 

Edit File pathname keywords 

Enters the specified editor and reads in pathname. 

pathname The pathname of the file to edit. The default is the usual file 

default. 

keywords :Editor 

:Editor {Simple, Zmacs} The style of editor to use. The default de- 

pends on your terminal: for the main screen, it is Zmacs, but 
if you are using a remote terminal, it is Simple. The Simple 
editor provides just the input editor and is useful only for 
small files. 



Edit Font Command 

Edit Font font 

Invokes the Font Editor with font loaded to be edited. 

font A font name. There is no default. Issuing the command with 

no arguments invokes the font editor with no font loaded. 

Edit Function Command 

:Edit Function function c-E 

Enters the Zmacs editor to bring up the current function or any other function for 
editing. This command lets you look at the function's source code. This is useful 
when you have found the function that caused the error and want to fix the code 
right away. The editor command c-Z returns to the Debugger, if it is still there. 

function A stack frame that you select with the mouse or a function 

spec that specifies which function you want to edit. (Default 
edits the current function.) 

Suggested mouse operations 

To edit a function: Point the mouse at the function's stack frame and press 
n-Left. 

Edit Namespace Object Command 
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Edit Namespace Object namespace-object keywords 

Modifies an object in the namespace database. 

To create a new object, see the section "Create Namespace Object Command". 



namespace-object 



Keywords 

: Insert Defaults 



:Locally 



A namespace object is specified by the class of the object fol- 
lowed by the name of the object. For instance, to specify the 
printer named Asahi, you enter: 

Edit Namespace Object printer Asahi 

If namespace-object is described in more than one namespace 
(is "multi-homed"), Edit Namespace Object prompts for the 
namespace in which you want to edit this object. (Typically, a 
namespace object is described only in one namespace.) 

:Insert Defaults, :Locally 

Toggles the Namespace Editor insert-defaults mode on or off 
for the current namespace object. The initial mode is off. 

When the insert-defaults mode is enabled for an object, the 
Namespace Editor inserts default values to the following indi- 
cators: 

File Control Lifetime 

Home Host 

Lispm Name 

Mail Address 

Pretty-Name 

Printer and Bitmap Printer 

Printer Interface 

Services 

Site 

See the section "The Insert Defaults Namespace Editor Com- 
mand" for details on how default values are derived. 

{Yes, No} The initial default is No, which updates the global 
namespace database (the namespace server) to reflect the 
changes you have made. Answer Yes to update only the local 
Lisp world with the changes you have made; the changes will 
be "forgotten" when you cold boot the local machine (unless 
you save the changed world). 

The default for this keyword is displayed along with the ob- 
ject's name, and, if you are editing multiple objects in the 
Namespace Editor, the current setting becomes the default for 
subsequent objects. 
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Edit System Command 

Edit System system-or-subsystem keywords 

Reads all the files that make up a system into editor buffers for editing. 

system-or-subsystem The system whose source files you want to edit. 
keywords : Include Components, : Query, : Silent 

: Include Components 

{Yes, No} Whether to edit component systems. The default is 
Yes. 

:Query {Everything, Yes, Confirm-Only, No} Whether to ask about 

editing each file. The default is No. The mentioned default is 
Everything or Yes, which are the same. If you select :Query 
Yes, you are asked about each file. Then a list of all the files 
you have selected is displayed and you are asked to confirm 
that you want to edit those files. If you select :Query Confirm- 
Only, you are only asked to confirm the list of files. You can 
answer Yes, No, or Selective. Selective allows you to answer 
Yes or No to each file in the list and finally displays a new list 
for you to confirm. 

:Silent {Yes, No} Whether to suppress all terminal output. The default 

is Yes. 



Enable Commands 

Enable Capabilities Command 

Enable Capabilities host capabilities 

Turns on specified capabilities for host after checking access requirements. The 
host prompts for your password for capabilities. 

host The name of the host on which you want to enable capabilities. 

capabilities One or more of the capabilities available for host. Each speci- 

fied capability must be already recognized by the server before 
access can be enabled. 

Enable Condition Tracing Command 

:Enable Condition Tracing condition keyword c-K T 
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Enables condition tracing. That is, this command allows you to debug an error 
handler when it does not work properly. For example, when you receive continu- 
ous, recursive error messages due to a defective error handler, you can use :En- 
able Condition Tracing to cause a trap and enter the Debugger before the condi- 
tion is signalled. Once in the Debugger, you can debug and fix the handler. 

You should use this command only if you code your own error handlers. If you do 
not code your own handlers, and suspect there is a bug in a handler, send a bug 
report to your Symbolics customer representative. 

Any numeric argument given with this command's accelerator sets sysrtrace- 
conditions to t. The c-K T accelerator toggles between :Enable Condition Tracing 
and :Disable Condition Tracing. 

condition {t, nil, conditions] t enters the Debugger when any condition 

is signalled, nil turns off condition tracing previously specified 
by t. condition is a condition flavor, which causes entry to the 
Debugger when any flavor built on conditions are signalled. 

keyword : Conditional 

:Conditional {Always, Mode-Lock, Never, Once} Enables condition tracing 

according to certain conditions. Always: enables condition trac- 
ing in all cases. Mode-Lock: enables condition tracing only 
when the MODE LOCK key is held down. Never: has the effect of 
disabling condition tracing. Once: enables condition tracing on- 
ly for the first time a condition is raised. (Default is Always.) 



Enable Network Command 

Enable Network network(s) 

Enables (turns on) the network service for the local machine. 

network(s) {network, All} The network(s) to enable. The possibilities are 

any of the networks to which your machine is connected. The 
default is All, meaning enable all network service on your ma- 
chine. 



Enable Services Command 

Enable Services service-type 

Turns on currently disabled service(s) on the local machine. 

service-type {All-Services, servicel, service2...} The service to turn on. The 

default is all-services. Press HELP for a list of available ser- 
vices. 
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Expunge Commands 

Expunge Directory Command 
Expunge Directory pathname keywords 

Expunges files marked for deletion. When Expunge Directory (m-X) 
is used to expunge multiple top-level directories by wildcard 
reference (such as >*> or >**>) the variable 
si:*expunge-notification-default* controls whether other users 
at the site will be notified first. If a numeric argument is provided, 
the value of this variable is locally forced to rquery. By default, 
the variable si:*expunge-notification-default* is :No. 



pathname The pathname of the directory to be expunged. The default is 

the usual file default. 

keywords :Delay After Notification :More Processing :Notify :Output Des- 

tination : Query 

:Delay After Notification 

{a time interval} When notifications are sent to other users, 
controls the length of time between notification and expunge. 
During the delay, the process can be aborted with Control- 
Abort, which both cancels the expunge and sends a notification 
that the expunge has been cancelled. By default, the variable 
si:*expunge-notification-delay-default* is :No. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Notify {Yes, No, Query} Controls whether other users at the site are 

notified when multiple top-level directories are to be expunged 
by wildcard reference, for example, >*> or >**>. When such 
wildcards are not used (or when such wildcards are only used 
to specify wild subdirectories of one or more specifically named 
toplevel directories, for example >Harry>*> or >Sal ly>**>), this 
option has no effect. By default, the variable si:*expunge- 
notification-default* is :No. 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} En- 



Page 2609 



ables you to direct your output. The default is the stream 
*standard-output*. Note that redirecting output to a printer 
can be particularly useful. 

:Query {Yes, No, Ask} Ask for confirmation before expunging the di- 

rectory. The default is No. The mentioned default is Yes. 
: Query is useful when pathname contains wildcard. 



Find Commands 

Find HackSaw Command 

Find HackSaw one-or-more-words keywords 

Finds a particular HackSaw. 

one-or-more-words {string} A word or words from a HackSaw to use as a search 
string. 

keywords :More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 
Suppose you saw a fact go by, but can't remember it now that you need it. If you 

can remember any of the topic words likely to have been in it, Find Hacksaw will 
find it. 



Find String Command 

Find String string keywords 

Finds files that contain one or more strings you specify, listing the line numbers 
and contents of the lines containing the string(s). 
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string 

keywords 

: Branch 
:Files 



The string to search for. You can specify more than one string, 
separated by commas. Files containing any of the strings speci- 
fied are found. 



:Branch, :Files, :Include Components, :More Processing, :Out- 
put Destination, :Patches,:Stop If Found, :Systems 

Reserved for future use. 

The pathnames of the files to be searched. The default is the 
usual file default. You must specify either this keyword or 
: Systems. 

: Include Components 

{Yes, No} Whether to include component systems of systems 
specified by the :Systems keyword. The default is No. The 
mentioned default is Yes. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



:Patches 



:Stop If Found 



: Systems 



Whether to include patch files for systems specified by the 
:Systems keyword. The default is Yes. 

{Yes, No} Whether to stop searching when the first occurrence 
of string is found. The default is No, the mentioned default is 
Yes. 

The systems or subsystems in which to search. You must speci- 
fy either this keyword or :Files. 



Examples: 



Find String (string(s) to search for) defun (keywords) :Files 

(the pathnames of one or more files [default equus:>ed>x.x.x]) equus:>ed>*. 1 isp 
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equus : >ed>f 1 ow-chart . 1 i sp 



Line #261 

Line #523 

Line #528 

Line #532 

Line #625 

Line #1070 

Line #1107 

Line #1182 

Line #1201 

Line #1222 

Line #1269 

Line #1279 

Line #1287 

Line #1307 



(defun draw-arrow (c-points window) 

(defun find-box (name) 

(defun connect-boxes (namel name2 &optional (arrow-p t) text) 

(defun create-boxes () 

QUOTE, SETQ, LET and DEFUN. Special operators 

(defun connect-eval -boxes () 

(defun connect-special -boxes () 

(defun get-user-response (test box-list) 

(defun print-results (form-and-args) 

(defun introduction () 

(defun var-exists (var env) 

(defun var-value (var env) 

(defun set-var (var value which-env local-env) 

(defun update-env-windows (env) 



Equus : >ed>scoreboard . 1 i sp . 22 
Line #34: (defun draw-team-box (x y) 
Line #45: (defun draw-score-box (x y) 
Line #55: (defun batter () 
Line #65: (defun count-balls () 
Line #74: (defun count-strikes () 
Line #81: (defun count-outs () 
Line #92: (defun new-batter() 
Equus : >ed>zwei -commands . 1 i sp . 1 
Line #27: (defun CENTER-MOUSE () 



22 lines matched in 3 files (5 files searched) 

Find String (string(s) to search for [default "defun"]) rotate (keywords) 
(one or more system or subsystems [default SITE]) Fed 



: Systems 



SYS:I01;FED. 

Line #61 : 
Line #130: 
Line #167: 
Line #169: 
Line #170: 
Line #171 
Line #172: 

Line #2882: 

Line #2899: 

Line #2915: 



LISP. NEWEST 

\l Set sample string 



© Rotate character 
#/© :COM-ROTATE-CHARACTER-RIGHT 



("Rotate" 



((NIL :VALUE : COM-ROTATE-CHARACTER-LEFT) 
(NIL :VALUE : C0M-R0TATE-CHARACTER-1 80) 
(NIL :VALUE : COM-ROTATE-CHARACTER-RIGHT) ) 
DOCUMENTATION "Rotate the character: 

L: 90 left, M: 180, R: 90 right") 
(DEFMETHOD (: COM-ROTATE-CHARACTER-RIGHT BASIC-FED) 

(IGNORE &AUX (OLD-PLANE PLANE)) 
(DEFMETHOD (: COM-ROTATE-CHARACTER-LEFT BASIC-FED) 

(IGNORE &AUX (OLD-PLANE PLANE)) 
(DEFMETHOD ( : COM-ROTATE-CHARACTER-180 BASIC-FED) 
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(IGNORE &AUX (OLD-PLANE PLANE) 
SYS : 1 01 ; FNTCNV .LISP. NEWEST 

Line #68: ; ROTATE-FONT[-DESCRIPTOR] , makes R(otated) fonts. 
I.e. landscape from portrait. 



Line #658 

Line #672 

Line #675 

Line #688 

Line #690 



(DEFUN ROTATE-FONT-DESCRIPTOR (FD &AUX LENGTH NFD) 
DO (ASET (ROTATE-CHAR-DESCRIPTOR CD) NFD CH)) 

(DEFUN ROTATE-CHAR-DESCRIPTOR (CD) 

(DEFUN ROTATE-FONT (FONT-SYMBOL &AUX FD NFD NFS) 
NFD (ROTATE-FONT-DESCRIPTOR FD) 



16 lines matched in 2 files (6 files searched) 

Find Symbol Command 

Find Symbol substring keywords 

Finds all symbols whose names contain substring. 

substring The string to look for in symbol names. 

keywords :More Processing, :Output Destination, :Packages, :Search In- 

herited Symbols, :Search Packages Used By, :Search Packages 
Using, :Type, :Verbose 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Packages {all, package-name, ...} The package(s) to search for symbols. 

The default is the current package. 

: Search Inherited Symbols 

{Yes, No} Whether to search imported symbols in the chosen 
packages. The default is Yes. 

:Search Packages Used By 

{Yes, No} Whether to search packages used by the chosen 
packages. The default is No. The mentioned default is Yes. 
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:Search Packages Using 

{Yes, No} Whether to search packages that use the chosen 
packages. The default is No. The mentioned default is Yes. 

:Type {All-Types, Class, Flavor, Function, Presentation-Type, Re- 

source, Unbound, Variable} The type of symbols for which to 
look. The default is All-Types. 

:Verbose {Yes, No} If verbose is Yes, the names of all packages searched 

are printed, whether matching symbols are found in them or 
not. If verbose is No, only the names of those packages where 
matching symbols are found are printed. The default is No, 
and the mentioned default is Yes. 



Flush Commands 

Flush Process Command 

Flush Process process 

Causes process to go into the state Wait Forever. This is one way to stop a run- 
away process that is monopolizing your machine and not responding to any other 
commands. A process that has been flushed can be looked at with the Debugger or 
Inspector and can be reset. 

process A process. You can press HELP for a list of all the processes 

currently running in your environment. (See the section "Show 
Processes Command".) 



Format Commands 

Format File Command 

Format File pathname keywords 

Displays the contents of one or more files in formatted form, using the Document 
Examiner formatter. 

pathname The file or sequence of files to be formatted. 

keywords :Destination, :Page Headings 

:Destination {screen, printer] The destination for formatted output. The de- 

fault is screen. The mentioned default is the default hardcopy 
text printer (the value of hardcopy:*default-text-printer*) if 
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that printer can handle formatted output; otherwise, the men- 
tioned default is the last printer used to produce formatted 
output; otherwise, there is no mentioned default. 

:Page Headings {Yes, No} Whether to print a heading line at the top of the 
page. The default is yes. The heading line consists of the word 
Page followed by the page number. 

Format File is similar to the Format File (m-K) Zwei command. The file to be for- 
matted must be a text file. It can contain the same formatting commands and en- 
vironments as files acceptable to Format File (m-K). See the section "Formatting 
Text in Zmacs". 

For example, to display a file in formatted form on the screen you might do the 
following: 

Format File (file) acme-blue:>project>documentation.mss 

To send the same file to a printer you might do: 

Format File (file) acme-blue:>project>documentation.mss 
(keywords) : Destination (a destination for formatted 
output [default Our-Printer]) Our-Printer 



Format Local SCSI Tape Command 

Format Local SCSI Tape keywords 

Formats a QIC-100 tape on a local SCSI drive. The drive must be local. 

keywords: :More Processing, :Output Destination 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

If your machine has only one SCSI drive, Format Local SCSI Tape formats the 
tape in that drive. If you have more than one drive on your machine, a menu pops 
up that allows you to specify the drive to use. 

If you do not want to bother with formatting tapes, you can purchase preformatted 
Gammamat 3M DC2000 mini-data cartridge (QIC-100) tapes for use with XL400 
and Maclvory systems with QIC-100 tape drives. 
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Format Topic Command 

Format Topic documentation-topic keywords 

Runs the formatter on the specified topic. 

documentation-topic The topic to format. A topic is the title of any documented sec- 
tion in any loaded documentation system, that is any topic in 
the candidates or bookmark panes in Document Examiner. 

keywords: :Destination 

:Destination {printer, Screen} Where to display the formatted topic. The de- 

fault is the default text printer. 



Halt Commands 

Halt commands shut down some activity in such a way that you can resume it. 

Halt GC Command 

Halt GC 

Turns ephemeral and dynamic garbage collection off. 

Halt Machine Command 

Halt Machine 

Stops execution of Lisp and gives control to the FEP. You can now enter FEP 
commands, for example, to warm or cold boot the machine. 

Halt Printer Command 

Halt Printer printer keywords 

Halts the specified printer. The printer does not print any requests until you start 
it using the "Start Printer Command". 

printer The name of the printer you are halting. 

keywords :Confirm, :Disposition, :Reason, :Urgency 

:Confirm {Yes, No} Whether to ask for confirmation. The default is Yes. 

:Disposition {Delete, Hold, Restart} Enables you to specify whether the sys- 

tem delete, hold, or restart the print request. The Delete op- 
tion deletes the request from the queue. Hold retains the re- 
quest in the queue but does not print it when the printer 
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restarts. Restart automatically prints the interrupted request 
from the beginning when the printer restarts. The default is 
Hold. 

:Reason {string} Enables you to specify the reason for the shutdown. 

This option appears in the display of the Show Printer Status 
command and in the Print Spooler log. The default message is 
"Printer printer-name being reset by user-id." 

You can use the following keyword to control precisely when the printer halts: 

:Urgency {Asap, After-Current-Request, After-Next-Copy} Enables you to 

specify when the printer halts. Asap indicates that the printer 
halt and reset immediately. After-Current-Request indicates 
that printer halt after the current request finishes printing. 
After-Next-Copy indicates that the printer halt after the next 
copy of the request prints. After-Next-Copy is the same as Af- 
ter-Current-Reqest when the request is only for one copy. The 
default is Asap. 

When you halt the printer, the Print Manager process enters a suspended state 
until you start it again. 

Note that you can halt, start, or reset a spooled printer from any machine on the 
network. 



Halt Process Command 

Halt Process process 

Causes process to stop immediately. This is the same as [Arrest] in the Peek pro- 
cesses menu. 

process A process. You can press HELP for a list of all the processes 

currently running in your environment. (See the section "Show 
Processes Command".) 



Hardcopy Commands 

Hardcopy File Command 

Hardcopy File pathname printer keywords 

Sends a file to a hardcopy device. 

pathname The pathname of the file you are printing. You can specify 

more than one file by separating the pathnames with commas. 
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printer 



keywords 



The printer on which you are printing the file. The default is 
the default hardcopy text printer (the value of 
hardcopy:*default-text-printer*). 

Body Character Style, :Copies, :Delete, :Ending Page, 
File Types, :Heading Character Style, :Notify, :Orientation, 
Print Cover Page, :Running Head, :Starting Page, :Title 



:Body Character Style 

The character style used for printing the text of the file. You 
can also use this character style for merging character styles 
in the file. See the section "Understanding Character Styles". 



:Copies 
:Delete 
:Ending Page 



{number} The number of copies you are printing. The default 
is 1. 

{Yes, No} Enables you to specify whether the file deletes after 
printing. The default is No, not to delete. 

{number} The last page you are printing. This command de- 
faults to the last page of the file. Note that the page character 
or form feed character identifies page breaks. The system 
treats text files without page breaks as a single page, although 
the file can use many sheets of paper. 

Press format files contain form feeds or PRGE characters. Re- 
member that these are physical pages and do not necessarily 
correspond to the page numbering appearing in the heading. 
For example, the first page of a press file is a title page, the 
second page is numbered i, and the third page is numbered 1. 

{ASCII, DMP1, LaserWriter, PostScript, Press, Text, XGP, use- 
canonical-type} The internal format of the contents of the file, 
to interpret for printing. The default is use-canonical-type, 
meaning that the type is determined from the extension to the 
file name. 

:Heading Character Style 

The character style used for the running head. 

:Notify {Yes, No} Specifies whether to send a notification upon job 

completion. The default is Yes. 

:Orientation {Landscape, Portrait} Specifies the paper orientation for the 

output. Portrait is left to right across the short dimension of 
the paper. Landscape is left to right across the long dimension 
of the paper. The default is Portrait. 

:Print Cover Page {Yes, No} Specifies whether to print a cover page. The default 
is Yes. 



:File Types 



:Running Head 



{None, Numbered} Specifies the type of running head that 
prints on the top of each page. The default is Numbered. 
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: Starting Page {number} The first page you are printing. This command de- 

faults to the first page of the file. The page character or form 
feed character identifies page breaks. The system treats text 
files without page breaks as a single page, although the file 
can use many sheets of paper. 

Press format files contain form feeds or PRGE characters. Re- 
member that these are physical pages and do not necessarily 
correspond to the page numbering appearing in the heading. 
For example, the first page of a press file is a title page, the 
second page is numbered i, and the third page is numbered 1. 

:Title {string} Specifies the title appearing on the cover page identi- 

fying the output. The default is "File: pathname-you-specified ". 



Hardcopy System Command 

Hardcopy System system printer keywords 

Prints the source file(s) for system on printer. 

system The system whose source to print. 

printer A supported hardcopy device. The default is the value of 

hardcopy : * default-text-printer* . 

keywords :Body Character Style, :Copies, :Heading Character Style, in- 

clude Components, :Orientation, :Query, :Running Head, :Silent, 
:Title, :Version 

:Body Character Style 

A fully specified character style. The character style in which 
to print the source file(s). See the section "Understanding 
Character Styles". 

:Copies {Number} The number of copies to make. The default is 1. 

:Heading Character Style 

A fully specified character style. The character style in which 
to print headings. See the section "Understanding Character 
Styles". 

: Include Components 

{Yes, No} Whether to include component systems. The default 
is No, the mentioned default is Yes. 

:Orientation {Landscape, Portrait} Orientation on the paper for the output. 

Portrait is left to right across the short dimension of the pa- 
per. Landscape is left to right across the long dimension. The 
default is Portrait. 
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:Query {Everything, Yes, Confirm-Only, No} Whether to ask about 

hardcopying each file. The default is No. The mentioned de- 
fault is Everything or Yes, which are the same. If you select 
:Query Yes, you are asked about each file. Then a list of all 
the files you have selected is displayed and you are asked to 
confirm that you want to hardcopy those files. If you select 
: Query Confirm-Only, you are only asked to confirm the list of 
files. You can answer Yes, No, or Selective. Selective allows 
you to answer Yes or No to each file in the list and finally dis- 
plays a new list for you to confirm. 

:Running Head {None, Numbered} Type of running head on each page. The 
default is Numbered. 



: Silent 
: Title 
:Version 



{Yes, No} Whether to suppress all terminal output. The default 
is No, the mentioned default is Yes. 

{string} Title to appear on the cover page. The default is "Sys- 
tem: system-you-specified ". 

{Released, Latest, Newest, version-designator] The major ver- 
sion of the system to hardcopy. The default is Newest. 



Help Commands 



Help Command 

Help commands keyboard keywords 

Displays a list of Command Processor commands. 

Specifies the Keyboard help category. 
Specifies the Commands help category. 



keyboard 

commands 

keywords 

: Format 



:Format, :Command Table 

{Brief, Full, Detailed} The level of detail to show in the list. 
The default is Brief. This is the same as pressing the HELP 
key. 

Brief means that only unique command names are shown in 
full; for the rest, the verb is shown with the number of com- 
mands that start with that verb. 

Full shows all commands in abbreviated form. 

Detailed displays the entire list of available commands. 

: Command Table The command table to show. 
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Initialize Commands 

Initialize Demonstration Command 

Initialize Demonstration name keyword 

Does any pre-loading specified in the demonstration definition, such as loading any 
required systems and running the initializer function. This command is not func- 
tionally necessary (because when a demonstration is first run, it is initialized au- 
tomatically, if it has not been initialized yet), but it can save time in situations 
when you want to have the first run of a demonstration be fast. 

name The name of a demonstration. 

keywords :Force 

:Force {Yes, No} Specifies whether to force initialization even if it 

has already been done. (Even when this is Yes, required sys- 
tems are not re-loaded — only the initializer action is re-run). 



Initialize Mail Command 

Initialize Mail 

Reloads Zmail without disturbing the rest of the system. The state of your mail on 
the machine is lost, so you should only use this when your Zmail process is ir- 
reparably stuck. 

Initialize Mouse Command 

Initialize Mouse 

Restarts the mouse process. This is useful if some window problem has caused the 
mouse to stop working. 

Inspect Commands 

Inspect Command 

Inspect object keywords 

Displays the components of object. This is similar to Show Object but it uses the 
Inspector, a window-oriented program for showing data structures. It allows you to 
do something to that object, such as inspect it, modify it, or give it as the argu- 
ment to a function. You exit from the Inspector by clicking the mouse on [Exit] in 
the Inspector menu. 
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object Any Lisp object. The default is "unspecified". 

See the section "The Inspector". 

Kill Commands 

Kill commands remove information from the world. You should use such commands 
with caution. 

Kill Process Command 

Kill Process process 

Causes process to go away completely. 

process A process. You can press HELP for a list of all the processes 

currently running in your environment. See the section "Show 
Processes Command". 

List Commands 

List commands display summary information. 

List Sage Variables Command 

No documentation available for section List Sage Variables Command. 

Load Commands 

Load File Command 

Load File pathname keywords 

Loads files into the current world. 

pathname The pathname of the file to load. More than one pathname 

may be specified, separated by commas. The default is the usu- 
al file default. 

keywords :Compile, :More Processing, :Output Destination, :Package, 

: Query, : Silently 

:Compile {Never, New-Source, Always} The default is Never. The men- 

tioned default is New-Source. 
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:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Package {package-name} The package into which to load the file. The 

default is the file's "home" package, as specified in its at- 
tribute list. 

:Query {Yes, No, Ask} Whether to ask for confirmation before loading 

each file. The default is No. The mentioned default is Yes. 

:Silently {Yes, No} Whether to print a line as each file is loaded. The 

default is No. The mentioned default is Yes. 



Load HackSaw File Command 

Load HackSaw File pathname 

Loads the standard HackSaw file plus all the ones defined by approach:*hacksaw- 
extension-files*. Loads HackSaws from private HackSaws files you designate. 

pathname {pathname, All} The pathname(s) of files to be loaded. The de- 

fault is All. If you give a pathname or pathnames, only those 
files are loaded. 

This command is optional and exists to avoid delays and to load personal HackSaw 
files. It is designed for use from an init-file with cprexecute-command. The stan- 
dard HackSaw files load themselves the first time Show HackSaw or n-HELP is 
used. 



Load Patches Command 

Load Patches system keywords 

Loads patches into the current world for all systems, locally maintained systems, 
or the indicated systems. 
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system {All Local system-namel, system-name2 ... } The system(s) for 

which to load patches. The default is All. 

keywords :Dangerous Patch Action, :Excluding, :Include Components, 

:More Processing, :Output Destination, :Query, :Save, :Show 

:Dangerous Patch Action 

{Skip, Query, Load} Whether to skip loading dangerous patch- 
es, that is, patches that might make data structures in your 
world inconsistent, causing unexpected behavior. The default is 
Skip. 

:Excluding {System(s)} Excludes loading patches for these systems. 

: Include Components 

{Yes, No} Whether to load patches for any component systems. 
The default is No. The mentioned default is Yes. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Query {Yes, No, Ask} Yes asks for confirmation before beginning the 

load patches process and again before loading each patch. Ask 
asks whether or not it should query before each patch, and 
then for confirmation before beginning the load patches pro- 
cess. The default is No. The mentioned default is Yes. 

:Save {pathname, Prompt, No-Save} The file in which to save the 

world with all patches loaded. Omitting this keyword means do 
not save the world. The mentioned default is Prompt, which 
means save the world and then prompt for a pathname. 

:Show {Yes, No, Ask} Whether to print the patch comments as each 

patch is loaded. The default is Yes. 

See the function load-patches. 
Load System Command 
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Load System system keywords 

Loads a system into the current world. 

system Name of the system to load. The default is the last system 

loaded. 

keywords :Component Version, :Condition, :Include Components :Load 

Patches, :More Processing, :Output Destination, :Query, :Redef- 
initions Ok, :Silent, :Simulate, Version 

: Component Version 

{Released, Latest, Newest, version-designator] The version of 
any component systems to load. Released means the version 
designated as released in the journal file. Latest means the 
most recent version recorded in the journal file. Newest means 
to ignore the versions in the journal file and just find the 
newest files. The default is the version with which the system 
was compiled. 

:Condition {Always, Never, Newly-Compiled} Under what conditions to 

load each file in the system. Always means load each file. New- 
ly-compiled means load a file only if it has been compiled since 
the last load. The default is Newly-Compiled. 

: Include Components 

{Yes, No} Whether to load component systems. The default is 
Yes. 

:Load Patches {Yes, No} Whether to load patches after loading the system. 
The default is Yes. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

: Query {Everything, Confirm-only, No} Whether to query before load- 

ing. Everything means query before loading each file. Confirm- 
only means create a list of all the files to be loaded and then 
ask for confirmation before proceeding. No means just go 
ahead and load the system without asking any questions. The 
default is No. The mentioned default is Everything. 
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:Redefinitions Ok {Yes, No} Controls what happens if the system asks for confir- 
mation of any redefinition warnings during the loading process. 
Yes means assume that all requests for confirmation are an- 
swered yes and proceed. No means pause at each redefinition 
and await confirmation. The default is No. The mentioned de- 
fault is Yes. This allows you to start loading a system that you 
know will take a long time to load and leave it to finish by it- 
self without interruption for questions such as "Warning: func- 
tion-name being redefined, ok? (Y or N)". 

:Silent {Yes, No} Whether to turn off output to the console while the 

system is loading. The default is No. The mentioned default is 
Yes. 

:Simulate {Yes, No} Print a simulation of what compiling and loading 

would do. The default is No. The mentioned default is Yes. 

:Version {Released, Latest, Newest, version-designator} Which version 

number to load. Released means the version designated as re- 
leased in the journal file. Latest means the most recent version 
recorded in the journal file. Newest means to ignore the ver- 
sions in the journal file and just find the newest files. The de- 
fault is Released. 

Note: This command only loads a system. If you want to compile and load a sys- 
tem, see the section "Compile System Command". 



Login and Logout Commands 

Login Command 
Login user keywords 
Logs the user into Genera. 



user 
keywords 

:Host 



:Init File 



Any string. Your user ID. 
:Host, :Init File 

{Local, any-host-name} A particular host computer. Local as an 
argument to :Host is particularly useful if your namespace sys- 
tem is down and you wish to log in to your Machine without 
having it try to use the namespace database. The default 
comes from home host for your user object in the namespace 
database. 

{Default-Init-File, File, Pathname, None} Whether to load your 
init file. The default is Default-Init-File. To avoid loading your 
init file, use :Init File None. 
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If someone is already logged in when you give the Login command, that user is 
logged out. If this happens, you see the message 

Warning — You are logging out from program-name 



Logout Command 

Logout keywords 

Logs you out of Genera. 

keywords :Expunge Mail, :Save Buffers, :Save Mail, :Save Spell Dictionar- 

ies, 

:Expunge Mail {Yes, No} Whether to expunge modified mail file buffers before 
saving them to disk. The default is Yes. 

:Save Buffers {Yes, No, Ask} Whether to write out modified editor buffers to 
disk. The default is Ask. 

:Save Mail {Yes, No, Ask} Whether to write out modified mail buffers to 

disk. The default is Ask. 

:Save Spell Dictionaries 

{Yes, No, Ask} Whether to write out modified spell dictionaries 
to disk. The default is Ask. 



Monitor Commands 

Monitor Screen Command 

Monitor Screen host 

Allows viewing the actual contents of some other lisp machine screen. It is useful 
for observing the state of file servers from afar, and for helping debug someone 
else's machine when it is not practical to get to the machine itself. 

host The name of a cooperating host. Note: The person whose 

screen is being monitored must explicitly turn on the server to 
allow someone else to see their screen. 

Monitoring is turned off by default. The person whose screen is being monitored 
must explicitly turn on the server to allow someone else to see their screen. They 
can choose to disallow remote viewing, allow remote viewing with a warning noti- 
fication, or allow remote viewing with no warning. They may also choose to make 
the operation of the server visible in the wholine, or to make it invisible. (The lat- 
ter is useful for watching file servers, when it is important to see something in 
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the wholine area such as open files, or some other progress indication that appears 
there. See also the "Show Open Files Command".) 

If the machine is not logged in, you can always monitor its screen. If the machine 
is logged in, however, monitoring is disallowed by default. You enable monitoring 
with the function chaosrenable-monitor-screen-server. 



chaosrenable-monitor-screen-server &key (.server-enabled mo) (:wholine-appearance 
rvisible) Function 

Allows someone else to monitor your screen using the Monitor Screen CP com- 
mand. Calling this function without any arguments disables monitoring your screen 
(the default). Note that, if your screen is already being monitored, the current 
monitoring session will not be terminated. 

: server-enabled One of :yes, :no, or motify. The default is :no. :no means no 
one can monitor your screen, ryes means anyone can monitor 
your screen, and you will not see a notification that they are 
doing so. motify means that anyone can monitor your screen, 
but you will see a notification first when they start. 

rwholine-appearance 

One of rvisible or rinvisible. The default is rvisible. When 
: server-enabled is ryes or motify, rvisible means that the 
wholine area will display the fact that the server is operating 
if someone is monitoring your screen, rinvisible means that the 
wholine area will not note whether anyone is monitoring your 
screen. 

Note that the server side of this capability has existed for many releases, though 
no easily-accessible user side existed. Even then, the default for the server was to 
disallow access. 

Site administrators, and others who build worlds, should not enable this facility in 
their world-building scripts, since allowing arbitrary monitoring of others' screens 
is generally considered a serious invasion of privacy. Users may wish to ensure 
that the worlds they run do not have this turned on by default. 

This is a Chaos-only protocol, meaning that only Chaosnet users can monitor 
screens. This means that sites which communicate with the outside world via 
TCP/IP, rather than Chaos (that is essentially all sites) do not have to worry about 
users elsewhere on the Internet monitoring any screens at their site, regardless of 
whether individual users enable monitoring. 

Many of these capabilities are not necessary if the machine(s) of interest run some 
remote window system, such as the X Window System. 

Screen monitoring only works if both machines are not embedded machines (for 
example, they are not UX-family or Maclvories). Both machines must have screens 
which are only one bit deep, that is, color or gray scale screens cannot be used. 

To monitor a screen, you do something like the following: 
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Monitor Screen (of cooperating host [default CARDINAL]) NUTHATCH 
To stop monitoring a screen, type any character. 

Monitor System Status Command 
Monitor System Status keywords 



Displays a summary of your machine's status. This includes the processes that are 
running, any open files, and whether or not you have new mail. 

keywords :Minimum Utilization, :Truncate Long Fields 

:Minimum Utilization 

{percentage} A process using less than this percentage of the 
machine should not be included in the summary. The default is 
0.1. 

: Truncate Long Fields 

{Yes, No} Whether to inhibit truncation of long field contents. 
The default is, Yes, to truncate long process names or states. 

Monitor System Status is useful when you are using a remote terminal, where 
Peek is not available. 



Monitor Variable Command 

Monitor Variable symbol keywords 

Monitors the access of a special variable. This command arranges for a trap to be 
signalled when any process accesses the monitored location. This command is used 
to answer the question: "What program or process is reading or writing this loca- 
tion in memory?". This is particularly useful when there are several processes 
sharing some data structures, and you want to debug the interactions between the 
processes. 

symbol The name of a symbol whose location in memory you want to 

monitor. Enter the name of a symbol and, optionally, its Value- 
Cell or Function-Cell. (See the :Cell keyword description be- 
low.) 

keywords :Boundp, :Cell, :Locf, :Makunbound, :Read, :Write 

:Boundp {Yes, No} Monitors the location for boundp operations. The 

default is No. The mentioned default is Yes. 

:Cell {Value-Cell, Function-Cell} Specifies the cell that you want to 

monitor within the location. The Debugger gives you two 
choices: Value-Cell or Function-Cell. The default is Value-Cell. 



:Locf 

:Makunbound 
:Read 
:Write 
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{Yes, No} Monitors the location for locf operations. (Default is 
No.) 

{Yes, No} Monitors the location for makunbound operations. 
The default is No. The mentioned default is Yes. 

{Yes, No} Monitors the location for reads. The default is No. 
The mentioned default is Yes. 

{Yes, No, Change} Monitors the location for writes. The de- 
fault is Yes. 



Suggested mouse operations 

• To monitor a location: Point the mouse at a locative, structure slot, or instance 
variable and press c-n-sh-Left. 

• To unmonitor a location: Point the mouse at a locative, structure slot, or in- 
stance variable that was previously monitored and press c-n-sh-Middle. 



Mouse Handler Commands 

The following Command Processor commands are available to provide information 
about mouse handlers defined in your world. 



Show Handlers For Types Command 

Show Handlers for Types context-type presentation-type keywords 

Lists the mouse handlers applicable in a specified input context to a specified ob- 
ject type and presentation type. 



context-type 



The input context (to-presentation-type in the handler defini- 
tion). 



presentation-type The presentation type of the presentation to which the mouse 
is pointing (the from-presentation-type in the handler defini- 
tion). 



keywords 



:More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 
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:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Mouse Handlers Command 

Show Mouse Handlers handler-name keywords 

Lists the handlers corresponding to handler-name, showing the input context, pre- 
sentation type, and handler type (object type) to which each is applicable. 

handler-name The name of a mouse handler. 

keywords :More Processing, :Output Destination, :Show Defined Han- 

dlers, :Show Table Handlers 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Show Defined Handlers 

{Yes No} Whether to list the handlers as described above. 

:Show Table Handlers 

{Yes No} Whether to show the expansion of the handlers in 
the handler lookup table. 



Show Presentation Handlers From Type Command 

Show Presentation Handlers From Type type keywords 

Lists the handlers defined with type as their from-presentation-type. 

type A presentation type. 

keywords :Include t, :More Processing, :Output-Destination 

:Include t {Yes No} Whether to include in the listing handlers defined on 

the t presentation type. 
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:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Mount Commands 

Mount Optical Disk Command 

Mount Optical Disk SCSI-address 

Mounts the optical disk indicated by SCSI-address. Once the disk is mounted, if it 
has a FEP filesystem on it, you can access it by using its FEP unit number. Oth- 
erwise, you should use the Create Initial FEP Filesystem command. 

SCSI-address The SCSI address of the optical disk drive. 

The convention for mapping SCSI addresses to FEP unit number is that the FEP 
unit number is 7 greater than the SCSI address. For example, if you set up the 
optical disk drive at SCSI address 4, the FEP unit is FEP 11. (Note that if you 
have multiple I/O boards, and the optical disk drive is attached to the second I/O 
board, then the FEP unit is 23 plus the SCSI address.) 

Optimize Commands 

Optimize World Command 

Optimize World keywords 

Optimizes the world that is currently loaded into your enviroment by reorganizing 
the world to improve paging performance. Use this command after you load site- 
specific software or layered products into a distribution world, and before you save 
it. 

Note: If you optimize an IDS world whose parent world was not (but should have 
been) optimized, your IDS world will be significantly larger than neccessary. 
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Use the Optimize World command on IDS worlds only if: 

• The parent world was optimized, or 

• The parent world didn't need optimization. 

If you follow this rule, optimization will not increase the size of your IDS world. 

Since distribution worlds are optimized before leaving Symbolics, if you site- 
configure a distribution world (but do not load any systems) you need not optimize 
it again. (This saves you some time in your world-building process.) 

When you enter the Optimize World command, you are prompted for confirmation. 
Once the program has finished, a message appears. Optimization typically takes 
about one-half hour to execute, but this time period can vary according to the size 
of the world load and the total amount of main memory that's available when you 
execute the command. 

During the time that Optimize World is running your machine does not respond to 
the network or keyboard; you cannot use your machine while optimization is in 
process. 

keywords :Show 

:Show Displays the progress of the optimization process on the 

screen. 



Read Commands 



Read Carry Tape Command 

Read Carry Tape keywords 

Loads files from a Carry-Tape. The loader makes no attempt to copy any file prop- 
erties, including author and creation date. It copies only file contents, and provides 
reasonable defaults for the target file name. See the section "The Carry-Tape 
Dumper". 

keywords :If Exists, :More Processing, :Output Destination, :Tape Spec 

:If Exists {Error, Skip, Supersede} Whether to Error, Skip, or Supersede 

files that are already on disk. The default is Skip. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
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subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Tape Spec The host and device for the tape. For more information, see 

the section "Tape Specifications". 



Read Image File Command 

Read Image File pathname format keywords 

Reads a picture or bitmap image from a file. 

pathname The pathname of the file from which to read an image. 

format The format of the data in the file. These are the possible 

image file formats: 

BIN Symbolics binary file (data only, compatible with all 

architectures) 

Compact Bitmap 

X windows "compact" bitmap 

EPS/Macintosh 

Postscript in the data fork, PICT in the resource 
fork 

Gem IMGUsed by Ventura Publisher 

GIF CompuServe Graphics Interchange Format 

Macintosh 

Macintosh based on type 

MacPaint MacPaint canvas (fixed size) 

PC Paintbrush 

PC Paintbrush format 

PICT Macintosh picture record 

Portable Bitmap 

X windows "portable" bitmap (l's and O's) 

PostScript 

Reads any PostScript images, writes EPSF compati- 
ble 

TIFF Tagged Image File Format 

Truevision 

Truevision product family format 
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Utah RLE 

University of Utah format Run-length-encoding 

X Bitmap X windows bitmap (C code) 

X Window Dump 

X v.ll window dump 



Xim 



X Image 



keywords 

:More Processing 



:More Processing, :Output Destination, :Rotate, :Trim 

{Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



: Rotate 



:Trim 



{Yes, No} Rotate the image 90 degrees (useful for MacPaint 
screen images). 

{Yes, No} Return the smallest image necessary to store just 
the ink. 



Read TAR File Command 

Read TAR File tarfile root-directory-for-relative-pathnames keywords 
Reads a file in TAR format. 



tarfile 



[a pathname} The TAR file to read. 



root-directory-for-relative-pathnames 

{a directory} The directory in which to put the files read. 

keywords :Mode, :More Processing, :Output Destination, :Reroot Absolute 

Pathnames 

:Mode {Binary, Query, Text} The mode in which to perform the copy. 

The default is Query, ask about each file. Binary means binary 
bytes with no character set translation. Text means text char- 
acters with UNIX character set translation. 

:More Processing 

{Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
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The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Reroot Absolute Pathnames 

{Yes, No} Uses the specified root directory as the "root" for 
absolute pathnames. The default is No. The mentioned default 
is Yes. 



Read TAR Tape Command 

Read TAR Tape root-directory-for-relative-pathnames keywords 

Reads a tape in TAR format. It prompts for the tape specification. 

root-directory-for-relative-pathnames 

{a directory] The directory in which to put the files read from 
the tape. 

keywords :Mode, :More Processing, :Output Destination, :Reroot Absolute 

Pathnames 

:Mode {Binary, Query, Text} The mode in which to perform the copy. 

The default is Query, ask about each file. Binary means binary 
bytes with no character set translation. Text means text char- 
acters with UNIX character set translation. 

:More Processing 

{Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 
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:Reroot Absolute Pathnames 

{Yes, No} Uses the specified root directory as the "root" for 
absolute pathnames. The default is No. The mentioned default 
is Yes. 



Remove Commands 



Remove Services From Hosts Command 

Remove Services from Hosts service-triples specific-hosts-or-all keywords 

Removes the specified service attributes in the namespace for one or more hosts. 

service-triples A service triple consists of a service, a medium, and a protocol. 

For more information, see the section "Concepts of Service, 
Medium, and Protocol". 

specific-hosts-or-all A list of hosts (or "all") from which you want to remove ser- 
vice. If you specify all, use the :Namespace, :Site, and :Type 
keywords. 



keywords: 
:Locally 



:Verbose 
:Namespace 

:Site 

:Type 



:Locally, :Verbose, :Namespace, :Site, :Type 

{Yes, No} The initial default is No, which updates the global 
namespace database (the namespace server) to reflect the 
changes you have made. Answer Yes to update only the local 
Lisp world with the changes you have made; the changes will 
be "forgotten" when you cold boot the local machine (unless 
you save the changed world). 

The default for this keyword is displayed along with the ob- 
ject's name, and, if you are editing multiple objects in the 
Namespace Editor, the current setting becomes the default for 
subsequent objects. 

Print messages for each host modified. 

Add the services to all hosts in the namespace (use with the 
"all" argument). 

Add the services to all hosts in the site (use with the "all" ar- 
gument). 

Add the services to all hosts of this system type (use with the 
"all" argument). 



Here is an example of removing netboot service from a host: 
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Remove Services From Hosts (Service Triples (service) netboot 

(medium) slap (protocol) netboot 

(A sequence of hosts or All) HARPAGORNIS 

Removing service NETBOOT SLAP NETBOOT from hosts. 
Done. 



Rename Commands 

Rename File Command 

Rename File from-file to-file keywords 

from-file The pathname of the file to be renamed. The default is the 

usual file default. 

to-file The new pathname. The default is the usual file default. 

keywords :Create Directories, :More Processing, :Output Destination, 

: Query 

:Create Directories 

{Yes, Error, Query} What to do if a destination directory does 
not exist. The default is Query. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Query {Yes, No, Ask} Whether to ask for confirmation before renam- 

ing. The default is No. 



Report Commands 
Report Bug Command 
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Report Bug system name 

Sends a bug report. It starts up a bug mail window with the message header To: 
BUG-system name. If system name is omitted, BUG-LISPM is used. Information from 
your herald identifing what version of the software you are using is inserted at 
the beginning of the message. You can now type in your bug report and send the 
message. 

You can control the character style of the herald information by setting the value 
of dbg:*character-style-for-bug-mail-prologue*. The default value is 
NIL.NIL.TINY. See the variable dbg:*character-style-for-bug-mail-prologue*. 



Reset Commands 

Reset Network Command 

Reset Network 

Turns your network interfaces off and back on again, and also resets the name- 
space system. Turning the interfaces off and on can be useful if your network con- 
nections appear to be stuck and nothing is being transmitted or received. Resetting 
the namespace system can cure problems caused by information related to the 
namespace having been corrupted on your local machine. One symptom of that is 
your host repeatedly trying to connect to another host, without success. 

The Reset Network command is the same as entering (neti:general-network-reset) 
followed by (netirenable). 

Reset Printer Command 

Reset Printer printer printer-request keywords 

Resets a spooled printer. You can use this command if your printer stops operating 
or if you have to stop the printer in the middle of a job. This command reestab- 
lishes communications with the printer and, when possible, sends a software "re- 
set" command to the printer. 

printer The name of the printer you are resetting. 

printer-request (Optional) Resetting a printer in the middle of a print request 

results in the system displaying the request and asking you to 
confirm the reset command. You have to specify the name of 
the print request or select the print request with the mouse 
from the display of the Show Printer Status command in order 
to reset the printer immediately. For more information, see the 
section "Show Printer Status Command". 

keywords :Confirm, :Disposition, :Reason 



: Confirm 
:Disposition 



:Reason 
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{Yes, No} Whether to request confirmation that the printer is 
printing a request. The default is Yes. 

{Delete, Hold, Restart} Enables you to specify whether the sys- 
tem delete, hold, or restart the print request. The Delete op- 
tion deletes the request from the queue. Hold retains the re- 
quest in the queue but does not print it when the printer 
restarts. Restart automatically prints the interrupted request 
from the beginning when the printer restarts. The default is 
hold. 

{string} The reason you are resetting the printer, which is 
added to the printer log. The default message is "Printer print- 
er-name being reset by user-id." 



Note that you can halt, start, or reset a spooled printer from any machine on the 
network. 



Restart Commands 



Restart Printer Request Command 

Restart Printer Request printer printer-request keywords 

Restarts a print request that you stopped before completion. For requests currently 
printing, the printer resets and the request prints from the beginning. For re- 
quests on hold, the printer requeues the request. 



printer-request 



keywords 
: Extent 

: Starting From 



A string specifying the request. You can select the print re- 
quest with the mouse from the display of the Show Printer 
Status command. You can also specify the printer name to 
which you sent the request and use "c-? and c-/" for display- 
ing all requests. For more information, see the section "Com- 
pletion in the Command Processor". 

:Extent, :Starting From 

{Entire, Copy} The extent to which you are restarting a re- 
quest. Entire refers to the whole request. Copy refers to a sin- 
gle copy. 

{number} The number of the copy after which the printer 
restarts. Note that you cannot use this keyword if you used the 
:extent keyword specifying Entire. The default is 0. This option 
is currently not used. 



Restart Process Command 
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Restart Process process 

Causes the process to start over in its initialized state. This is one way to get out 
of stuck states when other commands do not work. 

process A process. You can press HELP for a list of all the processes 

currently running in your environment. See the section "Show 
Processes Command". 



Restore Commands 

Restore Distribution Command 

Restore Distribution keywords 

Restores data from tape to disk. This command reads the directory listing of the 
files on tape, and then restores the files according to the pathname and property 
information on the tape. For each file it restores, Restore Distribution checks to 
see if the file already exists in the file system. If it does not exist, it restores the 
file. If the file does exist, the default behavior is that Restore Distribution states 
that the file already exists in your file system and skips the file. 

keywords :Menu, :More Processing, :Output Destination, :Skip Restora- 

tion, :Use Disk 

:Menu {Yes, No} Whether to use a menu interface to specify details 

of the restoration. Choosing Yes presents a Restore Distribu- 
tion frame to select which files are restored. The default is No. 
The mentioned default is Yes. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Skip Restoration {Yes, No} Whether to skip restoration of files that already ex- 
ist in the file system. If the file exists in the system and :Skip 
Restoration is No, Restore Distribution states that the file it 
was supposed to restore already exists in your file system, and 
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asks where to restore it instead. You supply a pathname. A 
pathname of Nowhere means skip this file. The default is Yes. 
The mentioned default is Yes. 

:Use Disk On all machines other than a Maclvory, the choices are {Yes, 

No}. If Yes, the input is read from a tape image file on disk. 
The default is No. The mentioned default is Yes. 

On a Maclvory, the choices are {Tape, Disk, Floppy}. Disk indi- 
cates the hard disk, and Floppy indicates the floppy disk. These 
two values also read a tape image file from disk or floppy. 
Tape means to read from tape; this is the default. 



Run Commands 



Run Demonstration Command 

Run Demonstration name keyword 

Runs a demonstration. If the demonstration has not been initialized, it will be ini- 
tialized automatically before it is first run. 

name The name of a demonstration. 

keywords :More Processing, :Output Destination, :Show Instructions, 

: Specify Options 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Show Instructions 

{Yes, No, Ask} Specifies whether to show instructions. The de- 
fault is Yes. 

:Specify Options {Yes, No} Specifies whether to interactively prompt for option 
values (if any) to control the demonstration. 
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Save Commands 

Save Compiler Warnings Command 

Save Compiler Warnings pathname files-whose-warnings-to-save 

Save compiler warnings of the files files-whose-warnings-to-save to the specified 
pathname, files-whose-warnings-to-save can be All to save all warnings, or it can be 
a list of one or more pathnames. Among the pathnames can be the special token 
No File to catch warnings for no particular file. 

Save File Buffers Command 

Save File Buffers keywords 

Saves your modified Zmacs file buffers on disk. 

keywords : Query 

:Query {Yes, No} The default is Yes, meaning that it asks you about 

each buffer before writing it out. 



Save Mail Buffers Command 

Save Mail Buffers keywords 

Saves on disk any modified mail buffers. 

keywords : Expunge, : Query 

:Expunge {Yes, No} Whether to expunge each buffer before saving. The 

default is Yes. 

:Query {Yes, No} The default is Yes, meaning that it asks you about 

each buffer before writing it out. 



Save World Command 

Save World (Complete or Incremental) pathname 

Saves the current world. The system prompts for (Complete or Incremental) if In- 
cremental Disk Save is enabled. Specify Complete to save the entire world, or In- 
cremental (if enabled) to perform an Incremental Disk Save. The default is Com- 
plete. 
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pathname The pathname for the saved world. The default is the FEP file 

specification for the local machine, based on the version num- 
ber of the current system and on whether this is a complete or 
incremental save. 

A complete save yields a pathname of Genera-major-minor or 
System-nnn-mmm. An incremental save changes this default in 
the following way: 

• "Genera-" is prefaced with "Inc-" 

• "System-" is replaced by "Inc-". 

• "-from-" is appended to the name. 

• A shortened version of the loaded world name (the pathname 
that appears in the first line of the herald) is appended to 
the name. 

• If the result is longer than 32 characters (the limit of file- 
names in the FEP file system), the filename is truncated 
and the last 4 characters within the limit are replaced with 
"-etc". 

More information is available about saving incremental worlds. See the section 
"Using the Incremental Disk Save (IDS) Facility". 



Scan Commands 

Scan Mail Command 

Scan Mail inbox keywords 

Allows you to look over your new mail, a message at a time, without loading the 
file into Zmail. For each message you are shown the headers and offered the rest 
of the message. You can press Y to see the text of the message, N to go on to the 
next message, R to reply to the message, or H to exit from Scan Mail. 

If you press Y, the message is displayed. You can stop the display by pressing 
RBORT at a More break or by pressing c-RBORT at any time. When the display is 
complete, you are offered the opportunity to reply to the message. You can press Y 
to reply, N to move on to the next message, or K to exit. 

If you press R, you are prompted for the headers, and left in a simple input editor 
context to type your message. Pressing END sends the message, RBORT aborts the 
message. 



inbox 

keywords 

:More Processing 
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The mailbox to scan. The default is the inbox for your main 
mail file. 

:More Processing, :Output Destination 

{Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during the output to interactive 
streams. The default is Default. 



:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

Scan Mail is useful for remote terminal use, where Zmail is unavailable, since it 
offers your mail one message at a time, with the option of operating on the mes- 
sage (unlike Show Mail, which only displays the contents of your inbox). 



Select Commands 

Select Activity Command 

Select Activity activity 

Selects activity and makes it current. 
Activity can be: 



Converse 

Distribute Systems 

Document Examiner 

Editor 

FEP-Tape 

File Server 

File System Maintenance 



Flavor Examiner 

Frame-Up 

Inspector 

Keyboard Control 

Lisp 

Mail 

Notifications 



Namespace Editor 

Peek 

Restore Distribution 

Select Key Selector 

Terminal 

Zmacs 

Zmail 



Send Commands 



Send Mail Command 

Send Mail recipient keywords 

Prompts for the text of a message and sends it as electronic mail to recipient. 

recipient One or more electronic mail addresses of the form user or 

user@host. Multiple addresses should be separated by commas. 
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If you supply only user, the namespace for your site is 
searched to locate the proper host for that user's mail. 

keywords :cc, :From, :Subject 

:cc {user, user@host} One or more addresses to send a cc, carbon 

copy, of the message. 

:From {user, user@host} The author(s) of the message, if different 

from the logged-in user. 

:Subject {string} A line to serve as the subject for the message. 



Send Message Command 

Send Message recipient 

Sends a Converse message to the specified recipient. 

recipient user or user@host. The person to whom to send the message. If 

@host is omitted, all Symbolics machines on your network are 
polled to locate user. 

Send Message prompts for text to send as a Converse message. END terminates and 
sends the message. See the section "Converse". 

Set Commands 

Set commands set status variables and user options. 

Set Base Command 

Set Base number 

Sets the input and output bases to number. See the variable *print-base*. 

number A number in base 10. The default is 10. 

Set Boot File World Command 

Set Boot File World world-load boot-file keywords 

Updates a boot file to load world-load. 

world-load {pathname} The pathname of a world load. 

boot- file {pathname} The pathname of the boot file to update. 

keywords : Create 
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: Create 



{Yes, No} Whether to create the boot file if it does not exist. 
The default is No. The mentioned default is Yes. 



Set Breakpoint Command 

Set Breakpoint compiled-function pc 

Sets a breakpoint. 

compiled-function The name of a compiled-function in which you want to set a 
breakpoint. 



pc 

keywords 
:Action 



: Conditional 



The PC (program counter) at which you want to set a break- 
point. 

: Action, : Conditional 

{Show- All, Show-Args, Show-Locals} Specifies an action to take 
when the breakpoint is encountered. Show-All: Displays argu- 
ments and local variables. Show-Args: Displays arguments and 
no local variables. Show-Locals: Displays only local variables. 
Give an expression if you want it to be evaluated in the lexical 
context of the frame. (Default is no action. Mentioned default 
is Show- All.) 

{Always, Mode-Lock, Never, Once} Executes the breakpoint 
trap according to certain conditions. Always: The breakpoint is 
always taken. Mode-Lock: The breakpoint is taken only when 
the MODE LOCK key is pressed. Never: The breakpoint is never 
taken. Once: The breakpoint is taken only for the first time it 
is encountered. Give an expression if you want it to be evaluat- 
ed in the lexical context of the frame. (Default is Always.) 

Suggested mouse operations 

• To set a breakpoint in a compiled function: Display disassembled code with the 
Show Compiled Code command, point the mouse at a PC, and press c-n-Left. 

• To set a breakpoint in a code fragment: Display the code with the Show Source 
Code command, point the mouse at a code fragment, and press c-n-Left. 



Set Command Processor Command 

Set Command Processor mode prompt-string keywords 

Sets the mode for the command processor. 



mode 



{Form-Only, Form-Preferred, Command-Preferred, Command- 
Only} How the Command Processor treats type-in. 
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prompt-string 



Form-Only Anything typed is taken as a Lisp form to 

be evaluated. 

Form-Preferred Anything typed is taken as Lisp forms un- 
less it is preceded by a colon (:), in which 
case it is taken as a Command Processor 
command. 

Command-PreferredAnything typed is taken as a Command 
Processor command, unless it is preceded 
by a left parenthesis. If it is not a com- 
mand, but a symbol with a value, it is 
evaluated. If it is both a command and a 
symbol with a value, it is treated as a com- 
mand unless it is preceded by a comma (,) 
or any nonalphabetic character. 



Command-Only. 



Anything typed is taken as a Command 
Processor command. 



The default is Command-Preferred. 

Any string. The default for command-preferred and command- 
only modes is Command : . The default for form-preferred and 
form-only modes is " ". To include a space in your prompt, you 
must enclose the string in double quotes. For example: 

Set Command Processor Command-Preferred "Command: " 
:Noise Strings 

{Yes, No} Whether to print prompts (noise strings) within the 
command. The default is Yes. Noise strings can also be turned 
off by setting si:*disable-noise-strings* to t. 

Set Command Processor only sets the prompt for the particular mode. You can set 
the prompt for all modes in your init file. See the section "Setting the Command 
Processor Prompt". 



keywords 

:Noise Strings 



Set File Properties Command 

Set File Properties pathname 

Brings up a menu that allows you to change the properties of a file. 

pathname The file whose properties you are modifying. 
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Change properties for S : >el 1 en> 1 i spn-i ni t . 1 i sp . 18 

Generation Retention Count: a. nunber or None 

Modification Date: 2/13/87 15:07:50 

Reference Date: 11/30/87 16:02:39 

Creation Date: 2/13/87 15:07:50 

Ruthor: Ellen 

Deleted: Yes No 

Don't Reap: Yes No 

Don't Delete: Yes No 

Don't Delete Reason: a. string or None 

< abort > aborts^ <1S1> uses these values 

The properties that you can change are: 

Generation Retention Count 

How many versions of this file to keep unmarked for deletion. 
Extra copies of the file are marked for deletion. 

Modification Date 

When this file was last modified. 

Creation Date When this file was created. 

Author Who created this file. 

Deleted Whether or not this file has been marked for deletion. 

Don't Reap Whether or not this file can be reaped. Reaping is deletion un- 

der program control. 

Don't Delete Whether or not this file can be explicitly deleted with a Delete 
command. 

Don't Delete Reason 

Why this file cannot be deleted. 



Set GC Options Command 

Set GC Options 

Select options for garbage collection from a menu. The menu looks like this: 

For more information about GC Options: See the section "Theory of Operation of 

the GC Facilities". 

Set Input Base Command 

Set Input Base new-base keywords 

Sets the input bases to new-base. See the variable *print-base*. 

new-base A number in base 10. The default is 10. 

Since the Input Base is closely linked to the Output Base, if you set one of them, 
you should set the other to the same value. 
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Command: Set GC Options 
Garbage col 1 ector status : 

Ephemeral GC : Off On 

Dynamic GC : Off On 

Garbage col 1 ector report control s : 

Report the activity of the ephemeral GC : Yes Ho 

Report the activity of the dynamic GC: Yes Mo 

Report space reclaimed individually for each area: Ves Ho Dynamic only Ephemeral only 

Enable warnings^ for example that the GC should be turned on: Yes Ho 

Minimum interval between repetitions of a GC warning: Forever 

Minimum adequate level of free space to suppress GC warnings: 1000000 

Minimum free space to suppress warnings when ephemeral GC is on: 200000 

Ratio of free space sizes on successive GC warnings: 0.75 

Disposition of GC reports: notification 

Show Ephemeral GC progress notes: Ho Foreground Only Ves Override 

Show Dynamic GC progress notes: Mo Foreground Only Ves Override 

Garbage collection options: 

Mormal garbage collection mode: Increnental Immediate 

Mode when free space is low: Turn GC off Immediate 

Mode when collecting ephemeral objects: Increnental Immediate 

Fraction of free space committed to the garbage collector: 1 

Minimum fraction of free space GC will accept: Same 

Garbage collector process controls: 

Process pri ori ty for foreground operati ons : 5 

Process priority for background operations: 

Process priority for immediate garbage collection mode: 5 

Priority of GC daemon processes: 5 

Delay before warning that flipping is inhibited: 30 seconds 

Time that processes wait before inhibiting flips: 5 seconds 

Scavenger performance options: 

Rmount of "scavenger work" done with interrupts inhibited: 1024 

Maximum time (microseconds) with interrupts inhibited: 50000 

Mumber of words scavenged before turning to another region: 12S 

Mumber of pages of Copy space to prefetch : 9 

Mumber of pages that refer to ephemeral objects to prefetch: 15 

Mumber of pages of Old space to prefetch: 5 

Mumber of words to look ahead for prefetchable Old space references: 204S 

Declare pages flushable from main memory after scavenging them: Ves Ho 

<rbqrt> aborts^ <eme> uses these values 



Figure 126. Set GC Options Menu 

Set Lisp Context Command 

Set Lisp Context lisp-syntax keywords 

lisp-syntax Zetalisp or Common-Lisp. 

Sets the current context to use Zetalisp or Common Lisp syntax and sets the cur- 
rent package zl-user (for Zetalisp) or cl-user (for Common Lisp). The default is 
the current Lisp syntax, so using the command with no arguments does not 
change anything. 

Set Output Base Command 

Set Output Base new-base keywords 

Sets the output bases to new-base. See the variable *print-base*. 
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new-base A number in base 10. The default is 10. 

Since the Output Base is closely linked to the Input Base, if you set one of them, 
you should be sure to set the other to the same value. 



Set Package Command 

Set Package package-name keywords 

Makes package-name the current package; in other words, the variable zhpackage 
is set to the package named by package-name. 

package The name of a package. 

keywords :More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Set Printer Command 

Set Printer printer-name keywords 

Sets the default printer for hardcopy. 

printer-name The name of a supported printer that can be reached by your 

machine. 

keywords :More Processing, :Output Destination, :Output Type 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 
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:Output Destination {Buffer, File, Kill Ring, Printer, Stream, Window} Enables you 
to direct the output of this command. The default is the 
stream *standard-output*. 

:Output Type {text bitmap both} Enables you to specify whether a printer 

prints text (files and mail messages), bitmap (graphics and 
screen hardcopy), or both text and bitmap. 



Set Process Priority Command 

Set Process Priority process value 

Adjusts the priority of process. 

process A process. You can press HELP or use the Show Processes com- 

mand for a list of all the processes currently running in your 
environment. 

value {number} For Foreground processes only. The priority value to 

give the process. Usually values range from -1 to 30, with most 
normal processes having priority 0. The mouse and keyboard 
process usually have priority 30 and some network processes 
have priority 10. The garbage collector and notifications have 
priority 5. Use Show Processes to see all your current process- 
es with their priorities. It is the relationship among the priori- 
ties that is important. The mouse and keyboard have a high 
priority so that user input is recognized and handled rapidly. 
Notifications should not take priority over keyboard or mouse 
input, but they should happen in a timely fashion. See the sec- 
tion "Choosing Process Priority Levels". 

Set Sage Variable Command 

No documentation available for section Set Sage Variable Command. 

Set Screen Options Command 

Set Screen Options 

Allows you to customize your screen by selecting parameters from a menu contain- 
ing all the screen options. Some of the options are global, affecting all screens. 
Those options that are per screen appear in the menu last, a set for each applica- 
ble screen. Thus, if you have a color screen connected to your machine, options for 
the Main Screen and for the Color Screen are displayed. You select options with 
the mouse or the keyboard. See the section "Using the Mouse and the Keyboard on 
Menus". 
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The options you can set and their values are: 
Documentation line options: 

Mouse documentation area height: 2 

Possible values: 1 or 2. 

Mouse documentation area background: Reverse Normal 

Mouse documentation area character style: 

SWISS.BOLD-CONDENSED-CAPS.NORMAL 

Possible values: a character style suitable for rscreen. See the 

section "Character Styles and the Lisp Listener". 

Status line options: 

Status area character style: FIX.ROMAN.NORMAL 

Possible values: a character style suitable for rscreen. 
Status line time display: [Mon 31 Jan 11:59:59] 12/31/89 23:59:59 Mon 31 Jan 

11:59pm 
Clock colon blink half period: 1 second 
Process display: User name Process name 
Machine name: Visible Invisible 
Progress area character style: FIX.EXTRA-CONDENSED.NORMAL 

Possible values: a character style suitable for :screen. See the 

section "Character Styles and the Lisp Listener". 
Progress area: Wide bar No display Text and thin bar 

Global Screen options: (These options are not applicable to Maclvory) 

Beep mode: Beep only Flash only Beep and flash 

Interval to wait before dimming screen: 20 minutes 
Dimness percentage: 

Global window defaults: 

End of screen action: Scroll Truncate Wrap 

Amount to scroll (number of lines or screen fraction): 1 

Overlap between screens when scrolling (lines): 1 

Whether to prompt in the CP: Yes No 

See the variable si:*disable-noise-strings*. 

Character style for prompts: NIL.NIL.NIL 

Possible values: a character style suitable for :screen. See the 
section "Character Styles and the Lisp Listener". 

Graphics Scan Conversion: Fast Accurate Specific flag mask 
Background interactor window settings: 
Position the interactor: At-Right At-Top 
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Fraction of the screen it covers: 3/4 

Keyboard and mouse repeat controls: 

(Note: on Maclvory, the Macintosh Control Panel also controls keyboard auto-repeat. 
These two auto-repeating controls are separate and turning them both on might cause 
unpredictable behavior.) 

Keyboard auto-repeats when any key is held: Yes No 

REPEAT key enabled: Yes No 

60ths of a second before key starts repeating: 42 

60ths of a second between repeated characters: 2 

Scroll bar auto-repeats when mouse button is held: Yes No 

60ths of a second before scroll bar starts repeating: 30 

Minimum number of lines scrolled per second: 2 

Maximum number of lines scrolled per second: 50 

Maximum number of screens scrolled per second: 2 

Other: 

Status line present on main screen: Yes No 

Per Screen options: 

Background gray pattern: None 5.5% 6% 7% 8% 9% 10% 12% HES 25% 33% 50% 

75% Black White 

If you define your own gray-array, its name is added to the 

list or, if your array does not have a name, the item Current 

is added. 
Partially exposed window gray pattern: None 5.5% 6% 7% 8% 9% 10% 12% HES 

25% 33% 50% 75% Black White 
Screen background: Black White (This option is not applicable to Maclvory) 
Highlighting mode for highlighting menus: Inverse Video Box 

Possible values: a character style suitable for rscreen or nil, 

the default, meaning the same character style but in inverse 

video. 

If you find that you always want to reset certain options, you can set them in your 
init file by using the Lisp function tvrset-screen-options. See the function tvrset- 
screen-options. 



Set Site Command 

Set Site site-name 

Configures the local distribution world to be an already existing site. 
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site-name {name, get-from-network} The name of your site. 

Any further arguments are entered through an AW menu that adjusts depending 
on the parameters needed. The Set Site command also fully supports multiple sites 
within one namespace so the site name does not have to match the namespace 
name, although one site in any namespace must have a name that is the same as 
the namespace name. 

If the Set Site command is used when the local machine is already registered in a 
site, the current site is changed to the distribution site before changing over to 
the new site. This is to eliminate any problems with dangling references to the 
previous site. 

The Set Site command enables your machine to identify all objects included in the 
site's namespace database. The namespace database for each site is stored in the 
file system accessible from a machine called the namespace server. 

In order for the Set Site command to work, your machine must be a registered 
host in the site's namespace. If the site's namespace server is not the local host, 
you must know the namespace server's name and network address. 

See the section "Set Site Dialogue". 



Set Stack Size Command 

:Set Stack Size stack-type stack-size 

Sets the size of a stack. 

stack-type The type of the stack. Enter Control, Binding, or Data. (De- 

fault is Control.) 

stack-size The size of the stack. Enter a number of machine words that 

represents the stack size. 

Set Time Command 

Set Time time keywords 

Sets the local time on your machine. This allows you to set the time that appears 
in the lower left hand corner of the status line if you need to. The default is con- 
structed from the status line time. 

time A date and time string, or the source from which to get the 

date and time, that is one of Network or Calendar Clock. 

keywords :Set Status Line, :Set Calendar Clock 

:Set Status Line {Yes, No, Ask} Whether or not to set the time in the status 
line. The default is Ask. 
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:Set Calendar Clock {Yes, No, Ask} Whether or not to set the internal backup clock 
of either the Symbolics machine or the embedding host com- 
puter, as the case may be. The default is Ask unless the time 
argument is Calendar Clock, in which case it defaults to No. 

Set Time accepts most reasonable printed representations of date and time and 
converts them to the standard internal forms. The following are representative for- 
mats that are accepted by the parser: 

"March 15, 1960" "15 March 1960" "3/15/60" "3/15/1960" 

"3-15-60" "3-15" "15-March-60" "15-Mar-60" "March-15-60" 

"1960-3-15" "1960-March-15" "1960-Mar-15" 

"1130." "11:30" "11:30:17" "11:30 pm" "11:30 am" "1130" "113000" 

"11.30" "11.30.00" "11.3" "11 pm" "12 noon" 

"midnight" "m" "Friday, March 15, 1980" "6:00 gmt" "3:00 pdt" 

"15 March 60" "15 March 60 seconds" 

"fifteen March 60" "the fifteenth of March, 1960;" 

"one minute after March 3, 1960" 

"two days after March 3, 1960" 

"Three minutes after 23:59:59 Dec 31, 1959" 

"now" "today" "yesterday" "two days after tomorrow" 

"one day before yesterday" "the day after tomorrow" 

"five days ago" 

Date strings in ISO standard format are accepted also. These strings are of the 
form "yyyy-mm-dd", where: 

yyyy Four digits representing the year 

mm The name of the month, an abbreviation for the month, or one 

or two digits representing the month 

dd One or two digits representing the day 

Following are some restrictions on strings to be parsed: 

• You cannot represent any year before 1900. 



• 



A four-digit number alone is interpreted as a time of day, not a year. For exam- 
ple, "1954" is the same as "19:54:00" or "7:54 pm", not the year 1954. 

The parser does not recognize dates in European format. For example, "3/4/85" 
or "3-4-85" is always the same as "March 4, 1985", never "April 3, 1985". A 
string like "15/3/85" is an error. In such strings, the first integer is always 
parsed as the month and the second integer as the day. 



Set Window Options Command 
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Set Window Options window 

Displays a menu of the settable options for window. See the section "Using 
Menus". 

Connand: Set Window Options (a window [default Dynanic Lisp Listenen 1]) "Dynanic Lisp Listenen 1" 

Mone processing enabled: Ves No 

Reuense yideo: Ves No 

Uentical spacing: 2 

Deexposed typein action: Uait until exposed Notify user 

-- r ■' : --" - ■ r -■' ■ " " ■' ' i : " ■ ■' " - r ■' : --" i ■' " ■ : -" I et it h inn-*ii :<■ * —■■■■-■■■ ' - 1- — ■ 
RLU function fon dnawing: Wnite Zenoes Urite Ones Conplenent Do Nothing 7 
ALU function fon enasing: Urite Zeroes Wnite Dnes Conplenent Do Nothing 2 
Screen manager priority: None an integer 
Save bits: Never Uhen Deexposed Whenever Used 

Graphics scan conversion: Fast Accurate Default Specific flag t\ask 
Default character style: FIX . RONfiN . NORNfiL 
Echo character style: NIL. NIL. NIL 
Typein character style: NIL. NIL. NIL 
End o f screen action: Default Scroll Truncate Wrap 



Figure 127. The Set Window Options Menu 



Show Commands 

Show commands allow you to request informational displays of all kinds. These 
displays are mouse sensitive when appropriate and can be used in composing other 
commands. For example, after a Show Directory display, the individual pathnames 
in the directory can be selected as arguments to a Show File command. 



Show Additional Patches Command 

Show Additional Patches system keywords 

Shows whether or not you are up to patch level in the specified system and option- 
ally displays the patch comments for those patches not yet loaded. 

system The system (or systems) to check for unloaded patches. The de- 

fault is All, to check all systems. 

keywords :Comments, :More Processing, :Output Destination 

:Comments {Yes, No, Ask} Whether or not to show the patch comments 

for any unloaded patches. The default is Ask, the mentioned 
default is Yes. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 
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:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Breakpoints Command 

:Show Breakpoints 

Displays all of the currently set breakpoints. 

Show Callers Command 

Show Callers symbol keywords 

Tries to find all the functions in the Lisp world that call symbol. 



symbol 


The name of a defined function whose callers to locate. 


keywords 


:Called How, :More Processing, :Output Destination, :Package, 




: System 


: Called How 


Lists only those callers that refer to symbol as a particular 




type of Lisp Object. The possible types are: 




Condition Flavor-Component Macro 




Constant Function Microcoded-Function 




Defined-Constant Generic-Function Unbound-Function 




Flavor Instance-Variable Variable 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Package Lists only those callers in the specified package. 

:System Lists only those callers from the specified system. 

See the function who-calls. 
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Show Carry Tape Command 
Show Carry Tape keywords 

keywords :More Processing, :Output Destination, :Tape-Spec, :Verify 

Describes what is on a Carry-Tape. Once started, it does not interact in any way. 
See the section "The Carry-Tape Dumper". 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Tape Spec The specifications for the tape. For more information, see the 

section "Tape Specifications". 

:Verify {Yes, No} Whether to verify the tape against the file system. 

The default is No. 



Show Class Generic Functions Command 

Show Class Generic Functions class keywords 

Shows all generic functions applicable to instances of the given class. 

keywords :Detailed, :Match, :More Processing, :Output Destination. 

:Detailed {Yes, No} Shows arguments, indicating (with "<!>") those 

which can be specialized for this class. The default is No 
(mentioned default is Yes). 

:Match {string} Shows only generic functions whose names contain this 

substring. The default is to show all generic functions. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 
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:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

Note that classes and methods are presented in the output in a way that enables 
you to click on them to perform operations on them. For example, you can click n- 
Left to edit a definition. 



Show Class Initargs Command 

Show Class Initargs class keywords 

Shows the initialization arguments accepted by closrmake-instance of this class, 
and any default initial values. Also shows slots affected by initargs. 

keywords :Detailed, :Direct, :Match, :More Processing, :Output Destina- 

tion, :Sort 

:Detailed {Yes, No} Shows affected slots and defaults. When :Detailed is 

No, you see the initializations from an external perspective 
(useful for making an instance). When :Detailed is Yes, you see 
the initializations from an internal perspective and get more 
information about how the class is constructed internally. (The 
mentioned default is Yes.) 

:Direct {Yes, No} Shows only initializations defined in this class. With 

:Direct Yes, inherited initializations are not shown. The default 
is No, which requests all initializations defined for this class 
or inherited by this class. (The mentioned default is Yes.) 

:Match {string} Shows initargs whose names contain this substring. 

The default is to show all initargs. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Sort (Alphabetical, Class} Sorts the display alphabetically by initarg, 

or by location in the class precedence list. The default is Al- 
phabetical. Class displays initargs in a format similar to the 
"Show Class Superclasses Command". 
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Note that classes and methods are presented in the output in a way that enables 
you to click on them to perform operations on them. For example, you can click n- 
Left to edit a definition. 



Show Class Methods Command 

Show Class Methods class keywords 

Shows methods applicable to this class. 

keywords :Direct, :Match, :More Processing, :Output Destination, :Stop 

At 

:Direct {Yes, No} Shows only methods applicable to instances of the 

given class; does not show methods inherited from superclass- 
es. The default is No (the mentioned default is Yes). 

:Match {string} Shows only methods for generic functions whose 

names contain this substring. The default is to show methods 
for all generic functions. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Stop At (superclass-name) Only look as far upward as this superclass, 

which is a superclass of the argument class (press HELP for a 
list of classes in their precedence order). The default is the di- 
rect subclass of t from which class inherits (the second-to-last 
element of class's precedence list). 

Note that classes and methods are presented in the output in a way that enables 
you to click on them to perform operations on them. For example, you can click n- 
Left to edit a definition. 



Show Class Slots Command 
Show Class Slots class keywords 
Shows the slots of the given class. 



keywords 



:Detailed 



:Direct 



:Match 
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:Detailed, :Direct, :Match, :More Processing, :Output Destina- 
tion, :Sort 

{Yes, No} Shows more detail, such as the accessors and ini- 
targs for the slots, as well as their names. The default is No 
(the mentioned default is Yes). 

{Yes, No} Shows only direct slots (that is, those defined for 
this class). Slots inherited from superclasses are not shown. 
The default is No (the mentioned default is Yes). 

[string] Shows slots whose names contain this substring. 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Sort {Alphabetical, Class} Sorts the display alphabetically by slot 

name, or by location in the class precedence list. If Class, each 
slot is displayed along with the class that provides it. The de- 
fault is Alphabetical. 

Note that classes and methods are presented in the output in a way that enables 
you to click on them to perform operations on them. For example, you can click n- 
Left to edit a definition. 



Show Class Subclasses Command 
Show Class Subclasses class keywords 
Shows the subclasses of this class. 



keywords 



: Brief 



:Detailed 



:Brief, :Detailed, :Duplicates, :Initargs, :Levels, :Match, :Meth- 
ods, :More Processing, :Output Destination, :Slots 

{Yes, No} :Brief Yes just shows the names of the subclasses of 
the class. :Brief No also shows the structure. The default is No 
(the mentioned default is Yes). 

{Yes, No} Shows more detail, such as the accessors and ini- 
targs for the slots, as well as their names. (This option is only 
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useful with : Slots.) The default is No (the mentioned default is 

Yes). 

:Duplicates {Yes, No} Shows classes everywhere they occur in the hierar- 

chy, not just in the place from which they derive their prece- 
dence. The default is No (the mentioned default is Yes). 

:Initargs {string} Shows initargs whose names contain this substring. 

This is useful, because the initarg is shown next to the class 
from which it is inherited. If string is omitted, requests all of 
them. If the keyword itself is not supplied, no initargs are re- 
quested. 

:Levels {integer} Specifies the number of levels of subclasses to show. 

Ellipses (...) indicate subclasses of a class that are not shown 
because of a :Level cutoff. The default is to show all subclass 
levels. 

:Match {string} Shows only the subclasses which contain this sub- 

string. 

:Methods {string} Shows methods for generic functions whose names 

match this substring. This is useful, because the method is 
shown next to the class from which it is inherited. If string is 
omitted, requests all of them. If the keyword itself is not sup- 
plied, no methods are requested. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Slots {string} Shows slots whose names contain this substring. This 

is useful, because the slot is shown next to the class from 
which it is inherited. If string is omitted, shows all of them. If 
the keyword itself is not supplied, no slots are requested. 

A subclass is a class that inherits from this class (directly or indirectly). This in- 
formation is useful in program development or debugging, to answer the question 
"Which classes will be affected if I change the definition of this class?" 

The output is indented to clarify the precedence order of the classes. The struc- 
ture of the output is the inverse of the output of Show Class Superclasses. 
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Note that classes and methods are presented in the output in a way that enables 
you to click on them to perform operations on them. For example, you can click n- 
Left to edit a definition. 



Show Class Superclasses Command 

Show Class Superclasses class keywords 

Shows the superclasses of this class in precedence order, from most specific to 
least specific. You can use this command to identify from which superclass a class 
derives part of its behavior. 



keywords 



: Brief 



:Detailed 



:Duplicates 



:Initargs 



:Brief, :Detailed, :Duplicates, :Initargs, :Match, :Methods, :More 
Processing :Output Destination, :Slots 

{Yes, No} :Brief Yes just lists the names of the superclasses of 
the class. :Brief No shows superclasses in outline form. The 
default is No (the mentioned default is Yes). 

{Yes, No} Shows more detail, such as the accessors and ini- 
targs for the slots, as well as their names. (This option is only 
useful with : Slots.) The default is No (the mentioned default is 

Yes). 

{Yes, No} Shows classes everywhere they occur in the hierar- 
chy, not just in the place from which they derive their prece- 
dence. The default is No (the mentioned default is Yes). 

[string] Shows initargs whose names contain this substring. 
This is useful, because the initarg is shown next to the class 
from which it is inherited. If string is omitted, requests all of 
them. If the keyword itself is not supplied, no initargs are re- 
quested. 

{string} Shows only the superclasses which contain this sub- 
string. 

{string} Shows methods for generic functions whose names 
match this substring. This is useful, because the method is 
shown next to the class from which it is inherited. If string is 
omitted, requests all of them. If the keyword itself is not sup- 
plied, no methods are requested. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 



:Match 



:Methods 
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:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Slots {string} Shows slots whose names contain this substring. This 

is useful, because the slot is shown next to the class from 
which it is inherited. If string is omitted, shows all of them. If 
the keyword itself is not supplied, no slots are requested. 

With :Brief No (the default), the classes are ordered from top to bottom, where the 
top class is the most specific class. The indentation graphically represents which 
classes are direct superclasses of which other classes. 

With :Duplicates Yes, bracketed classes are duplicates that are included as direct 
superclasses, but are not ordered in this position, because of some ordering con- 
straint. They appear in another place in the display without brackets, in their ac- 
tual order. All bracketed classes have an arrow beside them. A down-arrow indi- 
cates that this class's position in the ordering is later in the display. An up-arrow 
indicates that this class's position in the ordering is earlier in the display (these 
occurrences are infrequent). 

You can review the class precedence list by reading all unbracketed superclasses 
from top to bottom, ignoring punctuation. If :Duplicates is No, this is all that is 
displayed. 

For information on how the order is determined, see the section "CLOS Class 
Precedence List". 

Note that classes and methods are presented in the output in a way that enables 
you to click on them to perform operations on them. For example, you can click n- 
Left to edit a definition. 



Show CLOS Generic Function Command 

Show CLOS Generic Function generic-function-name keywords 

Shows information about the given generic function. 

keywords :Classes, :Methods, :More Processing, :Output Destination, 

:Sort, :Specialized 

:Classes {Yes, No, By Class} Lists classes that have methods defined for 

this generic function. The default is No (the mentioned default 
is Yes). By Class is like Yes, except that it presents the class 
objects themselves, rather than the names of the classes. 

:Methods {Yes, No, Detailed} Lists methods of this generic function. The 

default is No (mentioned default is Yes). Detailed shows more 
information. 
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:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Sort {Alphabetical, Heuristic} Sorts the methods by specializer 

names either alphabetically or heuristically. (Used with :Meth- 
ods Yes.) 

:Sort Heuristic sorts the methods in a way which takes into ac- 
count the argument precedence order, the class precedence or- 
der of the specializers, the alphabetical order of the class 
names, and the lengths of the method qualifier lists. 

:Specialized Only shows methods applicable to particular specializers (other- 

wise all methods are shown). For each required argument of 
the generic function which can be specialized, you are prompt- 
ed for an object to use for that argument, or a class to use as 
a specializer for that argument, or a wildcard to indicate that 
you want to see all methods, regardless of their specializers. 
(Used with :Methods Yes.) 

Note that classes and methods are presented in the output in a way that enables 
you to click on them to perform operations on them. For example, you can click n- 
Left to edit a definition. 



Show Command Table Command 

Show Command Table command-table keywords 
Shows the structure of a command table. 

command-table 

keywords :Locally, :More Processing, :Multiple Columns, :Output Desti- 

nation, :Show Commands 

:Locally {Yes, No} Whether to suppress recursive display of information 

about inherited command tables. The default is No, and the 
mentioned default is Yes. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
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The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Multiple Columns 

{Yes, No, integer} Whether to use multiple columns in the dis- 
play. The default is No, and the mentioned default is Yes. An 
integer number of columns is also permitted. This is especially 
useful for command tables such as Global which inherit from a 
large number of other command tables. 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} En- 
ables you to direct your output. The default is the stream 
*standard-output*. Note that redirecting output to a printer 
can be particularly useful. 

:Show Commands {Yes, No} Whether to show the commands in the command ta- 
ble. The default is Yes. If No is specified, then only command 
table names are shown, and but not the individual commands. 

The name of the command table is presented with descriptive information present- 
ed indented beneath it. Names shown in bold are command tables from which the 
command table inherits. Names shown in italics are commands in that command 
table. For example: 

Show Command Table (named) News 
News 

Monitor AP Newswire 
Sports 
Show Scores 
Record Bet 
Weather 
Show Weather Report 
Show Wind Chill Table 

This means that the command table News has one command of its own, Monitor 
AP Newswire, and inherits from two other command tables, Sports and Weather, 
each of which has two commands of its own. 



Show Command Processor Status Command 

Show Command Processor Status keywords 

Displays the current mode of the Command Processor and the current prompt. It 
also displays the prompts for the other modes. For example: 
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The command processor's current mode is 
Form Preferred: Interprets input starting with an alphabetic 
character as Lisp; 
type an initial : to force command interpretation. 

The prompt string is "->". 

The prompt strings for other modes are: 
Command Preferred: "Command: " 
Form Only: 
Command Only: "Command: " 

keywords :More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Compiled Code Command 

Show Compiled Code compiled-function-spec from-pc to-pc keywords c-K D 

Displays the disassembled code for a function. When you enter this command and 
specify a compiled-function-spec, the Debugger displays this message: 

Disassembled code for (function) ■. 

where function is the name of the compiled function for which you want to see dis- 
assembled code. Immediately under this message, the Debugger lists the disassem- 
bled code instructions for this function. Each instruction — PUSH, CALL, BRANCH, 
and so on — is listed on its own line, numbered by the PC (program counter). PCs 
are numbered in octal (base 8), and numbering begins with 0. 

compiled-function-spec 

The name of a compiled function for which you want to see 
disassembled code. (Default is the function in the current 
frame.) 
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from-pc The number of the PC at which you want to begin seeing dis- 

assembled code. (Default displays all disassembled code.) 

to-pc The number of the PC at which you want to stop seeing disas- 

sembled code. (Default displays disassembled code from PC 0, 
or from the number specified in from-pc, to the last PC in the 
disassembled code.) 

keywords :More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

Suggested mouse operations 

• To use this command with the mouse: Type in the Show Compiled Code com- 
mand. When the Debugger asks you for a compiled-function-spec, point the 
mouse at the name of a compiled function previously displayed in the output of 
another command, such as Show Backtrace or Next Frame, and click Left. (You 
can do this only when your previous command output includes the name of a 
compiled function.) 

• To set a breakpoint: Point the mouse at a PC in the disassembled code and 
press c-n-Left. 

• To clear a breakpoint: Point the mouse at a PC in the disassembled code and 
press c-n-Middle. 



Displays the disassembled code for the function associated with the current 
frame. 



Show Compiler Warnings Command 

Show Compiler Warnings pathname keywords 

Display compiler warnings for the files specified by pathnames. 
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pathname {pathnames(s) , All, No File} The compiled files whose warnings 

to show. All shows all compiler warnings for the compilation. 
No File shows the warnings for no particular file. The default 
is All. 

keywords :More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Crash Data Command 

Show Crash Data keywords 

keywords interpreted, :Output Destination 

interpreted Interprets the data in the current world. 

:Output Destination 

Directs the output of this command to a specified location. The 
location can be the pathname of a buffer or file, a printer, 
stream, or window. 

Obtains the most recent output from the FEP's Show Status command, and makes 
it available in the Lisp world. 

On 3600-family machines, this information includes some hardware state, the com- 
piled code program counter (macro PC), virtual memory address (VMA), stack 
pointer and frame pointer (SP and FP), and the 16 most recent microcode program 
counters (OPCs). 

On Ivory-based machines, the Mail Bug Report subcommand of the Debug FEP 
Command can be used to append the stack backtrace to the crash data obtained 
using the Command Processor (CP) Show Crash Data command. 

On both 3600-family and Ivory-based machines, the information displayed by the 
Command Processor (CP) Show Crash Data command is similar to the information 
displayed by the Show Status FEP command. However, Show Crash Data provides 
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an historical display; it shows the machine's status at the last crash. Show Status 
reveals the machine's current status (that is, its status when the command was 
issued). 

If you want to put all of the information from the Show Crash Data command in 
the current editor buffer or in a mail message, use the m-K Insert Crash Data 
Zmacs command. This makes it easy to include information about a Lisp crash 
that put you into the FEP. (This data is preserved even if you cold boot the ma- 
chine, but not if you reset the FEP.) 

The information retrieved from the Show Crash Data command is available until 
the next time Lisp halts, until the FEP is reset, or the machine is powered down. 
Therefore, even if you are unable to warm boot your machine, you can cold boot 
and then make a report with the data of the last crash. 

Here is a possible sequence of events: 

• The machine crashes and puts you into the FEP. 

• The FEP issues the Show Status command automatically. 

• On Ivory-based machines, you use the Debug FEP command and its Mail Bug 
Report subcommand. 

• Unless this is a fatal error, you use the FEP command Start to warm boot the 
machine. If this does not work, use the Load World and Start FEP commands to 
cold boot the machine. 

• You use the Command Processor (CP) Show Crash Data command in order to 
retrieve the most recent output of the Show Status FEP Command. 

• You use the m-K Insert Crash Data command in the editor to save the informa- 
tion in a buffer. 



Show Definition Documentation Command 

Show Definition Documentation name type keywords 

Shows the documentation string in the definition of the Lisp object name. 

name {symbol} A defined symbol. 

type The type of the object. The default determined from the defini- 

tion of the object. 

keywords :More Processing, :Output Destination 
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:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Demonstration Background Information Command 

Show Demonstration Background Information name keyword 

Displays background information about the demo which might help you understand 
where the demo came from or what it is trying to show, but which is not essential 
to actually running the demo. For example, if the demonstration is the Life game, 
this Show Demonstration Background Information might give information about 
who invented the Life game, the rules of the game, and other interesting informa- 
tion. 

name The name of a demonstration. 

keywords :More Processing, :Output Destination 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

Show Demonstration Instructions Command 

Show Demonstration Instructions name keyword 

Shows the essential instructions on how to use the demonstration. 
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name The name of a demonstration. 

keywords :More Processing, :Output Destination 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

Show Demonstration Legal Notice Command 

Show Demonstration Legal Notice name keyword 

Shows any copyright notices related to the demonstration. 

name The name of a demonstration. 

keywords :More Processing, :Output Destination 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

Show Demonstration Names Command 

Show Demonstration Names 

Shows the names of demonstrations which are available in the demonstrations fa- 
cility. 
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The output is mouse sensitive. Consult the mouse documentation line for informa- 
tion on the available options. 

The output is partitioned into "loaded" and "unloaded". The demonstration defini- 
tion resides in the file system and is not loaded until it is first referred to. Load- 
ing a demonstration loads only its definition, not its supporting code, and is there- 
fore always fast. When a demonstration is first run, it is initialized, which may 
take longer. 



Show Demonstration Summary Command 

Show Demonstration Summary name keyword 

Shows a brief summary of what the demonstration does. 

name The name of a demonstration. 

keywords :More Processing, :Output Destination 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

Show Differences Command 

Show Differences filel file2 keywords 

Compares filel and file2 and displays the differences. 

filel {pathname} The first file to compare. 

file2 {pathname} The file to which to compare filel. 

keywords :Ignore, :More Processing, :Output Destination 

: Ignore {Indentation, Case-and-Style} Aspects of the file contents to ig- 

nore when searching for differences. Indentation means whites- 
pace at the beginning of lines. Case-and-Style means capitaliza- 
tion and character style information. 
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:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

When Show Differences encounters a difference between two files, it displays the 
text from filel first followed by the text from file2. For each difference encoun- 
tered, it displays last line that was the same in both files, followed by the different 
text up to and including the next line that matches in both files. 

For example: 

Source compare made by KJones on 9/06/87 16:28:02 -x-Fundamental-x- 

of File W:>KJones>l ispm-init. 1 isp.3 

with File W:>KJones>l ispm-init. 1 isp. 4 

xxxx File W:>KJones>l ispm-init. 1 isp.3, Line #5, After "(load "sys: 1 isp;my-project") ' 

; ; ;Set up the toolkit. 

xxxx File W:>KJones>l ispm-init. 1 isp. 4, Line #5, After "(load "sys: 1 isp;my-project") ' 

(1 oad " tuna : >kj ones>exampl es>decorate" ) 

; ; ;Set up the toolkit. 
Done. 



Show Directory Command 

Show Directory pathname keywords 

Displays a directory listing. The default for name, type, and version of pathname is 
:wild. The format of the listing varies with the operating system. For more infor- 
mation, see the section "Examining the Lisp Machine File System" and see the 
section "Interpreting Directory Listings in FSEdit". 

pathname The pathname of the directory to list. The default is the usual 

file default. 

keywords :Author, :Before, :Excluding, :More Processing, :Order, 

:Output Destination, :Since, :Size 
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Author {user-id} Show those files written by this user. 

Before {date} Show only those files created prior to this date. 

Excluding {filel, file2 ... } Exclude files that do not match the indicated 

wildcard filenames from the directory listing. Logical path- 
names and pathnames having versions specifiers of "oldest" and 
"newest" are not permitted as excluded files because the exclu- 
sion test will be done against the truename of the physical 
pathname, and such pathnames would never match. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 



: Order 



{oldest-first, smallest-first, largest-first, newest-first, standard} 
Show files in this order. The default is standard, which is usu- 
ally alphabetical. 



:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



: Since 
:Size 



{date} Show only those files created after this date. 

{integer} Show only those files the same size or larger than in- 
teger blocks. The default is 0, meaning that all files will be 
listed, even if they are empty. 



Show Disabled Services Command 

Show Disabled Services keywords 

Shows you which services are disabled (with the Disable Services Command). 

keywords :More Processing, :Output Destination 



:More Processing 



{Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 
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:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Disk Label Command 

Show Disk Label unit keywords 

Displays the information in the disk label of the specified disk unit. 

unit {integer, All} The unit number of the disk whose label to show. 

All shows the labels of all disks connected to the machine. 

keywords :More Processing, :Output Destination 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during the output to interactive 
streams. The default is Default. 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

Show Disk Label (unit number [default 0]) 

Pack name: Unknown 

Comment: Don't tread on me 

FEP kernel: FEP0:>I325-kernel.fep.9 

Backup FEP kernel: FEP0:>i317-kernel.fep.6 

Color Startup File: 



Show Disk Usage Command 

Show Disk Usage files keywords 

Displays information about the amount disk space used by files. 

files {pathname(s)} The file or directories for which to display disk 

use. 

keywords :More Processing, :Output Destination 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 
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:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

A line of information about the disk use of each host is also provided. For exam- 
ple: 

Connand: Show Disk Usage RCME : >KJones> 

RCME: 8875 free, 403595/412470 used (9??., 3 partitions) 
(LMFS records, 1 = 5056. 8-bit bytes) 
RCME: >KJones >*.*.* uses 5,823 blocks in 213 files. 



Show Distribution Directory Command 

Show Distribution Directory keywords 

Describes the contents of a distribution tape, or a dummy distribution file. For 
each file in the distribution, this command displays the file's logical pathname, and 
the physical pathname to which it would be restored. See Figure 19. 

keywords :More Processing, :Output Destination, :Use Disk 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Use Disk On all machines other than a Maclvory, the choices are {Yes, 

No}. If Yes, the input is read from a tape image file on disk. 
The default is No. The mentioned default is Yes. 

On a Maclvory, the choices are {Tape, Disk, Floppy}. Disk indi- 
cates the hard disk, and Floppy indicates the floppy disk. These 
two values also read a tape image file from disk or floppy. 
Tape means to read from tape; this is the default. 
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Distribution listing^ 12/01/8? 18:08:31 

Systens on this tope: 

LMFS, TAPE, UTILITIES, SERUER-UTILITIES, HRRDCOPV 

Files on this tape: Translated pathnanes: 
In system LhTS : 

1 SYS :LMFS;LMFS. LISP. 105 Q : >rel -7>sys> 1 nf s> 1 nf s . 1 i sp . 105 

2 SYS:LhTS; PATCH; LhTS. SY ST EM-DIR. 83 Q : >rel -7>sys> 1 nf s> patch > 1 nf s . systen-di r . 83 

3 SYS :LMFS; PATCH; LMFS-94 . COMPONENT-DIR . 1 Q : >rel -7>sys> 1 nf s> patch? 1 nf s-94> 1 nf s-94 . conponent-di i- . 1 

4 SYS:LMFS;PRTCH; LMFS-94. PRTCH-DIR.l Q : >rel -7>sys> 1 nf s>patch> 1 nf s-94> 1 nf s-94 . patch-di r . 1 
In systen TAPE: 

5 SYS:LMTRPE;TRPPKG.LISP.47 Q : >rel -7>sys> 1 ntape>tappkg . 1 i sp . 47 

6 SYS:LMTRPE;TRPE.SYSTEM-DIR.127 Q : >rel -7>sys> 1 ntape> tape . systen-di r . 127 

7 SYS :LMTRPE;TRPE-74. COMPONENT -DIR.l Q : >rel -7>sys> 1 ntape>tape-74>tape-74 . conponent-di i- . 1 

8 SYS:LnTRPE;TRPE-74.PRTCH-DIR.3 Q : >rel -7>sys> 1 ntape>tape-74>tape-74 . patch-di r . 3 

9 SYS:LMTRPE;TRPE-74-l.BIN.l Q : >rel -7>sys> 1 ntape>tape-74>tape-74-l . bi n . 1 
In systen UTILITIES: 

10 SYS:SYS;UTILITY-SYSDCL.LISP.51 Q : >rel -7>sys>sys>uti 1 i ty-sysdcl . 1 i sp . 51 

11 SYS : PATCH; UTILITIES. SYSTEM-DIR. 55 Q : >rel -7>sys>patch>uti 1 i ti es . systen-di r . 55 

12 SYS:PRTCH; UTILITIES-20 . COMPONENT -DIR . 1 Q: >rel -7>sys>patch>uti 1 ities-20>uti 1 i ti es-20 . conponent-di r . 1 



Figure 128. Part of the Display from Show Distribution Directory 

Show Documentation Command 

Show Documentation topic keywords 

Displays the documentation for topic. If topic is more than one word, it must be 
enclosed in quotation marks. 

Show Documentation (for topic) "Getting Acquainted With Genera" 

keywords :Destination 

:Destination {screen, or printer name}. Where to display (print) the docu- 

mentation. The default is to display the documentation on the 
screen. Mentioning the :Destination keyword changes the de- 
fault to the default hardcopy device, if it is a supported print- 
er, or to the supported printer most recently used for format- 
ted output. 

See the section "Document Examiner". 

Show ECOs Command 

Show ECOs keywords 

Shows any ECOs (Engineering Change Orders) loaded into your world. 

keywords :More Processing, :Output Destination 
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:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Editor Buffer Command 

Show Editor Buffer buffer keywords 

Displays the contents of the specified editor buffer (buffer). 

buffer The buffer whose contents to show. Pressing HELP displays a 

list of all your editor buffers. 

keywords :More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Effective Method Command 

Show Effective Method generic-function specializers keywords 

Lists the applicable methods of generic-function with the arguments described by 
specializers. For each required argument of the generic function which can be spe- 
cialized, you are prompted for an object to use for that argument, or a class to use 
as a specializer for that argument. 
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keywords 



:Code 



:More Processing 



:Code, :More Processing, :Output Destination 

{Yes, No} Shows code resulting from method combination. The 
default is No (the mentioned default is Yes). 

{Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

Note that classes and methods are presented in the output in a way that enables 
you to click on them to perform operations on them. For example, you can click n- 
Left to edit a definition. 



Show Expanded Lisp Code Command 
Show Expanded Lisp Code form keywords 

Shows the lisp definition of form. See Figure 



form 



keywords 



{macro name None} 



The Lisp form whose code to expand. 
Specifying None causes the command to prompt you for a 
macro form to evaluate just as if you had used (mexp). See the 
function mexp. 

:As If Compiler, :Constant Folding, :Expand, :More Processing, 
:Output Destination, :Repeat, :Whole Form 



:As If Compiler 
: Constant Folding 

:Expand 

:More Processing 



{Yes, No} Does everything the compiler would do to the 
form. The default is No. The mentioned default is Yes. 

{Yes, No} Does any constant computations, arithmetic for 
instance, that will not change and thus can be done now. 
The default is No. The mentioned default is Yes. 

{macros, inline-functions, style-checkers, optimizers, con- 
stants} Does macro expansion. The default is to expand 
inline-functions and macros. 

{Default, Yes, No} Controls whether **More** processing 
at end of page is enabled during output to interactive 
streams. The default is Default. If No, output from this 
command is not subject to **More** processing. If De- 



:Output Destination 



:Repeat 



:Whole Form 
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fault, output from this command is subject to the prevail- 
ing setting of **More** processing for the window. If Yes, 
output from this command is subject to **More** process- 
ing unless it was disabled globally (see the section "FUNC- 
TION M"). 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The 
default is the stream *standard-output*. 

{Yes, No} Takes the output and operates on it again to 
expand it fully. The default is No. The mentioned default 
is Yes. 

{Yes, No} Expands recursively until the innermost code 
loop is expanded. The default is Yes. 



Example: 



Command: Show Expanded Lisp Code (defmacro form ()()) 

(PROGN (SI:DEFMRCRO-CLERR-INDENTRTION-FOR-ZWEI 'FORM) 
(MRCRO FORM (SI:. FORM. SI:. EMU.) 
(DECLRRE (RRGLIST)) 
(BLOCK FORM 
(TRGBODY 

(LET* NIL 

(RND (CDR SI: .FORM.) 

(GO tt:G3615)) 
(IGNORE SI: .EMU.) 
(RETURN-FROM FORM 
(PROGN NIL))) 
tt:G3615 (RETURN-FROM FORM 

(SI:DEFMRCRO-RRGUMENT-ERROR 'FORM 'NIL SI :. FORM .))))) ) 



Figure 129. Expansion of defmacro form 



Show Expanded Mailing List Command 

Show Expanded Mailing List electronic-mailing-list keywords 

Shows the list of individuals who receive messages sent to a mailing list. 

electronic-mailing-list 

The name of a mailing list (from the file 

>mai 1 >stati omai 1 boxes . text) 



keywords 
:A11 Levels 



:A11 Levels, :Matching, :More Processing, :Output Destination 

{Yes, No} Whether to show the expansion of mailing lists that 
are included in the selected mailing list. The default is yes, ex- 
pand all lists down to individuals. 
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:Matching {string} Shows only those names on the mailing list matching 

string. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show FEP Directory Command 

Show FEP Directory keywords 

Displays a description of the FEP files on the local host. The :Host keyword allows 
you to specify another host. 

keywords :Format, :Highlight Files In Use, :Highlighting Mode, :Host, 

:More Processing, :Output Destination, :Type, :Unit 

:Format {Normal, Detailed} How much information to include in the 

display. The default is Normal, meaning file name, length in 
blocks, and file comment (if any) are displayed for each file. 
Detailed means that all information, including creation date 
and author, is displayed. 

:Highlight Files In Use 

{Yes, No} Whether to indicate files that are currently in use. 
The default is Yes. This keyword works only when displaying 
the FEP file system of the local host. 

:Highlighting Mode 

{Bold, Arrow} How to indicate that a file is in use. Bold means 
display the filename in boldface, Arrow means prefix the file- 
name with an arrow. (The arrow is useful from a remote ter- 
minal.) The default is Bold except on remote terminals, where 
the default is Arrow. 

:Host A host on the network. The default is local. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
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command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Type {All, Boot, Fep, LMFS, Microcode, Other, Paging, World} The 

type of file(s) to display information about. The default is All. 
More than one type can be given, separated by commas. 

:Unit {disk-unit-number All} The default is All. disk-unit-number is 

an integer, interpreted as a disk unit number on the specified 
host. 

Show FEP Directory first displays the number of free blocks and the proportion of 
blocks used on each disk unit. It then displays a summary of the files on each unit 
grouped by file type. 



Show File Command 

Show File pathname keywords 

Displays a file on the screen. If there is more than one screenful, it pauses be- 
tween screenfuls displaying — More — at the bottom. 

pathname The pathname of the file to be displayed. The default is the 

usual file default. 

keywords :More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 
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Show Flavor Components Command 

Show Flavor Components flavor keywords 

Shows the order of the components of this flavor. 

keywords :Brief, :Detailed, :Duplicates, :Functions, :Initializations, in- 

stance Variables, :Match, :Methods, and :Output Destination. 
See the section "Keyword Options for Show Flavor Commands". 

:Duplicates {Yes, No} Indicates whether or not to display duplicate occur- 

rences of flavors. The default is No. 

:Brief {Yes, No} Yes indicates that the output should not be indented 

to show the structure. The default is No. 

The flavor components are ordered from top to bottom. The top flavor is the most 
specific flavor in the ordering. The indentation graphically represents which flavors 
are components of which other flavors. In the example below, tvrminimum-window 
has six direct components: tvressential-expose, tvressential-activate, tvressential- 
set-edges, tv:essential-mouse, tvressential-window, and flavorrvanilla. 

When you use the duplicates keyword and show the components of complex fla- 
vors, you notice special symbols in the display. For example: 

Command: Show Flavor Components T\/:MINIMUM-WINDOW duplicates 
— > T\/:MINIMUM-WINDOW 

TV: ESSENTIAL-EXPOSE 

[T\/:ESSENTIAL-WINDOW] I 
TV: ESSENTIAL-ACTIVATE 

[T\/:ESSENTIAL-WINDOW] I 
TV:ESSENTIAL-SET-EDGES 

[T\/:ESSENTIAL-WINDOW] I 
TV: ESSENTIAL-MOUSE 
T\/:ESSENTIAL-WINDOW 
TV:SHEET 

SI:OUTPUT-STREAM 
SI:STREAM 
FLAVOR MANILLA 

Bracketed flavors are duplicates that are included by the parent flavor here, but 
are not ordered in this position because of some ordering constraint. They appear 
in another place in the display without brackets, in their correct order. All brack- 
eted components have an arrow beside them. A down-arrow indicates that this 
component's position in the ordering is later in the display. An up-arrow indicates 
that this component's position in the ordering is earlier in the display; these oc- 
currences are infrequent. 

For example, the flavor tvressential-window is a component of four other compo- 
nents: tvressential-expose, tvressential-activate, tvressential-set-edges, and 

tvrminimum-window itself. Its correct position in the ordering is directly after 
tvressential-mouse, where it appears without brackets. 



Page 2685 



You can read the order of flavor components by reading all unbracketed flavors 
from top to bottom, ignoring punctuation. If :Duplicates is No, this is all that is 
displayed. 

For information on how the order is determined, see the section "Ordering Flavor 
Components". 



Show Flavor Dependents Command 

Show Flavor Dependents flavor keywords 

Shows the names of flavors that are dependent on this flavor. 

keywords :Brief, :Detailed, :Duplicates, :Functions, :Initializations, in- 

stance Variables, :Levels, :Match, :Methods, :Output Destina- 
tion. See the section "Keyword Options for Show Flavor Com- 
mands". 

:Brief {Yes, No} Yes indicates that the output should not be indented 

to show the structure. The default is No. 

duplicates {Yes, No} Indicates whether or not to display duplicate occur- 

rences of flavors. The default is No. 

:Levels {All, integer] Specifies how many levels of indirect dependency 

to display. The default is all, which shows all levels. For some 
flavors the output can be voluminous, and it is helpful to use 
:Levels to pare it down. 

A dependent flavor is a flavor that uses this flavor as a component (directly or 
indirectly). This is useful in program development or debugging, to answer the 
question "What flavors will be affected if I change the definition of this flavor?" 
For example: 

Command: Show Flavor Dependents T\/:SCROLL-WINDOW-WITH-DYNAMIC-TYPEOUT 
— > T\/:SCROLL-WINDOW-WITH-DYNAMIC-TYPEOUT 
TV: BASIC-PEEK 

TV: PEEK-PANE 
TV: BASIC-TREE-SCROLL 
LMFS:AFSE-MIXIN 

LMFS:FSMAINT-AFSE-PANE 
LMFS:FSMAI NT-HI ERED-PANE 
TV : MOUSABLE-TREE-SCROLL-MIXIN 
TV: TREE-SCROLL-WINDOW 

The output is indented to clarify which flavor is built on which component flavors. 
The structure of the output is the inverse of the output of Show Flavor Compo- 
nents. In this example, tv:basic-peek is a direct dependent of tv: scroll- window- 
with-dynamic-typeout, and tv:peek-pane is a direct dependent of tv:basic-peek. 
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Show Flavor Differences Command 

Show Flavor Differences flavorl flavor2 keywords 

Shows the characteristics that two flavors have in common, and the characteristics 
in which they differ. 

keywords :Match, :More Processing, :Output Destination. See the section 

"Keyword Options for Show Flavor Commands". 

:Match {string} Displays only those generic functions or messages that 

match the given substring. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

This is most useful for two flavors that share many characteristics. Here is some 
sample output: 

Command: Show Flavor Differences T\/:ESSENTIAL-WINDOW T\/:MINIMUM-WINDOW 
— > T\/:ESSENTIAL-WINDOW and TV : MINIMUM-WINDOW have 
common components: 

flavors... 
T\/:MINIMUM-WINDOW has other components: 
flavors... 

Differences in ACTIVATE methods from T\/:ESSENTIAL-WINDOW 

to T\/:MINIMUM-WINDOW 
T\/:SHEET before, primary, 
TV: ESSENTIAL-ACTIVATE after [added] 

Differences in handling of :BURY 

Flavor TV: ESSENTIAL-WINDOW does not handle :BURY 
Methods of T\/:MINIMUM-WINDOW: 

TV: ESSENTIAL-EXPOSE wrapper, TV : ESSENTIAL-ACTIVATE 
more differences... 

First, the common components are displayed. Second, the extra components of ei- 
ther (or both) flavors are displayed. Third, any differences in handling of generic 
functions are displayed. 
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In this example, tvrminimum-window has one method for ractivate that 
tvressential-window does not have: an rafter method provided by flavor 
tvressential-activate. The term [added] indicates that this method is defined for 
the second flavor but not for the first flavor. If the command had been given such 
that flavor-1 was tvrminimum-window and flavor-2 was tvressential-window, the 
term would have been [deleted]. To interpret which flavor "adds" or "deletes" a 
method, look at the line that defines the perspective: "Differences in : ACTIVATE 
methods from TV:ESSENTIAL-WINDOW to TV:MINIMUM-WINDOW". 

When comparing two complex flavors, the output can be voluminous. You can use 
:Match to pare down the output so it answers a specific question. For example: 

Command: Show Flavor Differences DYNAMIC-LISP-LISTENER SHEET : Match 
screen 
— > information about common and different components... 
Difference in handling of :FULL-SCREEN 

Method of DW: :DYNAMIC-LISP-LISTENER: TV : ESSENTIAL-SET-EDGES 
Flavor TV:SHEET does not handle generic operation :FULL-SCREEN 
another difference... 

5 local functions found with no differences: 
TV : SCREEN-MANAGE-RESTORE-AREA 
TV : SCREEN-MANAGE-CLEAR-AREA 
TV : SCREEN-MANAGE-CLEAR-UNCOVERED-AREA 
TV : SCREEN-MANAGE-CLEAR-RECTANGLE 
TV : SCREEN-MANAGE-MAYBE-BLT-RECTANGLE 

15 differing local functions were found that did not 
contain the substring "screen". 



Show Flavor Functions Command 

Show Flavor Functions flavor keywords 

Shows internal flavor functions for the given flavor. 

keywords :Locally, :Match, :Output Destination, and :Sort. See the sec- 

tion "Keyword Options for Show Flavor Commands". 

:Locally {Yes, No} If yes, inherited internal flavor functions are not 

shown. The default is no, which shows all internal flavor func- 
tions defined for this flavor or inherited by this flavor. 

:Match {string} Displays only those internal functions that match the 

given substring. 

Internal flavor functions are defined by defun-in-flavor, defmacro-in-flavor, and 
defsubst-in-flavor. See the section "Defining Functions Internal to Flavors". 
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Command: Show Flavor Functions TV:WIND0W 
— > TV:ADJUST-MARGINS 

SI:ANY-TYI-CHECK-EOF 

SI :ASSURE-INSIDE-INPUT-EDITOR 

others... 



Show Flavor Handler Command 

Show Flavor Handler operation flavor keywords 

Provides information on the handler that performs operation (which can be a 
generic function or a message) on instances of flavor. 

keywords :Code and :Output Destination. See the section "Keyword Op- 

tions for Show Flavor Commands". 

:Code {Yes, No, Detailed} Specifies whether the Lisp code of the han- 

dler should be displayed. The default is No. Yes displays a tem- 
plate that resembles the actual code of the handler. Detailed 
displays the actual code of the handler. This displays some in- 
ternal functions and data structures of the Flavors system. For 
most purposes, Yes is more useful than detailed. 

If the handler is a single method (not a combined method), its function spec is 
given: 

Command: Show Flavor Handler CHANGE-STATUS CELL 

— > The handler for CHANGE-STATUS of an instance of CELL is 
the method (FLAVOR: METHOD CHANGE-STATUS CELL). 
The method-combination type is :AND :MOST-SPECIFIC-LAST . 

If the handler is a combined method, the method combination type and order of 
methods are displayed. In the following example, the methods used in the com- 
bined method are represented by the names of the flavors that implement them. 
Even in this abbreviated format, the representation of the method is mouse- 
sensitive. 

Command: Show Flavor Handler CHANGE-STATUS BOX-WITH-CELL 
— > The handler for CHANGE-STATUS of an instance of 
BOX-WITH-CELL is a combined method, with 
method-combination type :AND :MOST-SPECIFIC-LAST . 
The methods in the combined method, in order of 
execution, are: CELL, BOX-WITH-CELL 

For combined methods, :Code Yes is useful. It requests a template that resembles 
the actual code of the handler: 
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Command: Show Flavor Handler CHANGE-STATUS BOX-WITH-CELL :Code yes 
— > The handler for CHANGE-STATUS of an instance of 
BOX-WITH-CELL is a combined method, with 
method-combination type :AND :MOST-SPECIFIC-LAST . 
(DEFUN (FLAVOR:COMBINED CHANGE-STATUS BOX-WITH-CELL) 

(SELF SYS: SELF-MAPPING-TABLE FLAVOR: :. GENERIC . 
&REST FLAVOR: : DAEMON-CALLER-ARGS . ) 
(AND call (FLAVOR: METHOD CHANGE-STATUS CELL) 

call (FLAV0R:METH0D CHANGE-STATUS BOX-WITH-CELL))) 



Show Flavor Initializations Command 



Show Flavor Initializations flavor keywords 

Shows the initialization keywords accepted by make-instance of this flavor, and 
any default initial values. 



keywords 



:Detailed 



:Locally 



:Match 



For example: 



:Detailed, :Locally, :Match, :Sort, and :Output Destination. See 
the section "Keyword Options for Show Flavor Commands". 

{Yes, No} The default is No, which requests the allowed ini- 
tialization keywords that can be given to make-instance of 
this flavor, including init keywords and initable instance vari- 
ables. If :Detailed is Yes, any additional instance variables are 
also shown; these are not initable instance variables. They are 
initialized by default values given in the defflavor form. Also, 
any initialization methods are shown. In other words, when 
:Detailed is No, you see the initializations from an external 
perspective (useful for making an instance). When :Detailed is 
Yes, you see the initializations from an internal perspective 
and gain information about how the flavor is constructed in- 
ternally. 

{Yes, No} If Yes, inherited initializations are not shown. The 
default is No, which requests all initializations defined for this 
flavor or inherited by this flavor. 

{string} Requests only those initializations matching the given 
substring. 
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Command: Show Flavor Initializations BOX-WITH-CELL :Detailed 

— > Instances of BOX-WITH-CELL are created in the default area 
Another area can be specified with the keyword :AREA 
Initialization keywords that initialize 
instance variables: 
:B0X-X -> BOX-X 
:B0X-Y -> BOX-Y 

:SIDE-LENGTH -> SIDE-LENGTH, default is *SIDE-LENGTH* 
:STATUS -> STATUS, default is (IF (EVENP (RANDOM 2)) 

' :ALIVE ' :DEAD) 
:X -> X 
:Y -> Y 
Initialization method: 

MAKE-INSTANCE method: BOX-WITH-CELL 



Show Flavor Instance Variables Command 

Show Flavor Instance Variables flavor keywords 

Shows the state maintained by instances of the given flavor. 



keywords 



:Detailed 



:Locally 



:Sort 



For example: 



:Detailed, :Locally, :Match, :Output Destination and :Sort. See 
the section "Keyword Options for Show Flavor Commands". 

{Yes, No} If Yes, the attributes of the instance variables are 
shown, such as their accessibility or initializations. The default 
is No. 

{Yes, No} If Yes, inherited instance variables are not shown. 
The default is No, which shows all instance variables defined 
for this flavor or inherited by this flavor. 

{Alphabetical, Flavor} If Flavor, each instance variable is dis- 
played along with the component flavor that provides it. The 
default is Alphabetical. 



Command: Show Flavor Instance Variables CELL 
— > NEIGHBORS 
NEXT-STATUS 
STATUS 
X 
Y 



Show Flavor Methods Command 

Show Flavor Methods flavor 
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Displays all methods defined for the given flavor. 

Keywords :Locally, :Match, :Output Destination, :Sort, and :Using In- 

stance Variables. See the section "Keyword Options for Show 
Flavor Commands". 

:Locally {Yes, No} If Yes, inherited methods are not shown. The default 

is No, which shows all methods defined for this flavor or in- 
herited by this flavor. 

:Match {string} Requests only those methods for generic functions that 

match the given string. 

:Using Instance Variable 

[name] Requests only those methods that use the instance 
variable named name. 

Each line of output contains the name of the generic function, followed by the 
name of each flavor that provides a method for the generic function. If the method 
is not a primary method, its type is also displayed. 

Command: Show Flavor Methods BOX-WITH-CELL 
— > ALIVENESS method: CELL 

CHANGE-STATUS methods: CELL, BOX-WITH-CELL 
COUNT-LIVE-NEIGHBORS method: CELL 
DESCRIBE method: FLAVOR: VANILLA 
others... 

This command is similar to Show Flavor Operations. See the section "Show Flavor 
Operations Command". The difference between the two commands is in the per- 
spective: 

Show Flavor Methods displays information from an internal perspective, answering 
the question: What methods are defined for this flavor, or inherited from its com- 
ponent flavors? 

Show Flavor Operations displays information from an external perspective, answer- 
ing the question: What operations (generic functions and messages) are supported 
by instances of this flavor? 



Show Flavor Operations Command 

Show Flavor Operations flavor keywords 

Shows all operations supported by instances of the given flavor, including generic 
functions and messages. 

keywords :Detailed, :Match, and :Output Destination. See the section 

"Keyword Options for Show Flavor Commands". 
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:Detailed {Yes, No} If Yes, the display shows the arguments of each op- 

eration. The default is No. 

:Match {string} Shows only those operations matching the given sub- 

string. 



For example: 




Command: 


Show Flavor Operations BOX-WITH-CELL 


— > 


ALIVENESS 




CHANGE-STATUS 




COUNT-LIVE-NEIGHBORS 




DESCRIBE 




MAKE-INSTANCE 




SYS:PRINT-SELF (: PRINT-SELF) 



others... 

One of the operations can be performed by using the generic function sysrprint- 
self or sending the message :print-self. This operation was defined with 
defgeneric, using the rcompatible-message option. 

This command is similar to Show Flavor Methods. See the section "Show Flavor 
Methods Command". The difference between the two commands is in the perspec- 
tive: 

Show Flavor Operations displays information from an external perspective, answer- 
ing the question: What operations (generic functions and messages) are supported 
by instances of this flavor? 

Show Flavor Methods displays information from an internal perspective, answering 
the question: What methods are defined for this flavor, or inherited from its com- 
ponent flavors? 



Show Font Command 

Show Font font 

Displays all characters of the font. You can get a list of the fonts loaded by press- 
ing HELP after typing Show Font or by clicking on List Fonts in the Font Editor. 
You enter the Font Editor by using the Edit Font command with no arguments. 

font Font name. 



Show Function Arguments Command 

Show Function Arguments function-spec keywords 

Shows arguments of the function specified by function-spec. 
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keywords :More Processing, :Output Destination. See the section "Key- 

word Options for Show Flavor Commands". 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show GC Status Command 

Show GC Status keywords 

Displays statistics about the garbage collector. 

keywords :More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 
See the section "Theory of Operation of the GC Facilities". See the section "Set GC 

Options Command". 



Show Generic Function Command 

Show Generic Function operation keywords 

Shows information on the given operation, which can be a generic function or 
message. 



keywords 



:Methods 



:Flavors 



For example: 
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:Flavors, :Methods and :Output Destination. See the section 
"Keyword Options for Show Flavor Commands". 

{Yes, No} Yes displays all methods for the generic function, 
and their types. 

{Yes, No} Yes displays the flavors that implement methods for 
the generic function. 



Command: Show Generic Function CHANGE-STATUS 

— > Generic function CHANGE-STATUS takes arguments: (CELL-UNIT) 

This is an explicit DEFGENERIC in file SYS: EXAMPLES; FLAVOR-LIFE. 
Method-combination type is :AND :MOST-SPECIFIC-LAST . 



Show HackSaw Command 

Show HackSaw keywords 

keywords :More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

Shows an interesting fact about Genera. This command is bound to n-HELP. 



Show Handlers For Types Command 

Show Handlers for Types context-type presentation-type keywords 

Lists the mouse handlers applicable in a specified input context to a specified ob- 
ject type and presentation type. 



context-type 



The input context (to-presentation-type in the handler defini- 
tion). 



presentation-type The presentation type of the presentation to which the mouse 
is pointing (the from-presentation-type in the handler defini- 
tion). 
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keywords :More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Herald Command 

Show Herald keywords 

Displays the herald message. The herald is a a multiline message displayed when 
you cold or warm boot, use the Command Processor (CP) Show Herald or Save 
World commands, or use the Disk Restore FEP command. 

The herald shows you the name of the FEP file or partition for the current world 
load, any comment added to the herald, a measure of the physical memory and 
swapping space available, the versions of the systems that are running, the site's 
name, and the machine's own host name. 

When you cold or warm boot, your machine displays a full-screen herald. When 
you display the herald with the Show Herald command, you see an abbreviated 
herald. 

keywords :Detailed, :More Processing, :Output Destination 

:Detailed {Yes, No, Normal} Whether or not to print the version infor- 

mation in full detail. Normal displays the systems which are 
usually of interest to users. Yes displays more systems than 
does Normal. No shows only machine information and release 
level, and no information about system versions. The default is 
Normal. The mentioned default is Yes. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
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subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

For information about herald-related functions: 

• See the function sctrget-system-version. 

• See the function sctrprint-system-status-warning. 



Show Hosts Command 

Show Hosts host-spec keywords 

Asks each of the hosts for its status, and prints the results. If no hosts are speci- 
fied, asks all hosts on the Chaosnet. Hosts can be specified by either name or octal 
number. 

For each host, a line is displayed that either says that the host is not responding 
or gives metering information for the host's network attachments. If a host is not 
responding, probably it is down or there is no such host at that address. A Symbol- 
ics host can fail to respond if it is looping inside without-interrupts or paging ex- 
tremely heavily, such that it is simply unable to respond within a reasonable 
amount of time. 

host-spec A host or list of hosts (names or network addresses) or sites, 

separated by commas. 

keywords :More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Page 2697 



For example: 

Show Hosts Wombat 

Show Hosts chaos | 23557 

Show Hosts Wombat, Kangaroo, Wal laby 

The display looks like this: 

Chaosnet host status report. Type Control -Abort to quit. 

Site Name/Status Subnet tt-in #-out abort lost crc ram bite other 

23557 Wombat 51 4615995 89709 22 8214524 07749784 919 

Site The Chaosnet address of the host, in this case 23557. 

Name/Status The name of the host, in this case Wombat. 

Subnet For sites with large networks, the number of the subnet on 

which host resides, in this case 51. 

#-in The number of Chaosnet packets received by host since it was 

last cold booted. 

#-out The number of Chaosnet packets transmitted by host. 

abort The number of packets host attempted to send but was unsuc- 

cessful due to network collisions. 

lost The number of incoming packets that host was forced to dis- 

card. 

crc Cyclic Redundancy Check. The number of packets that failed 

this check, because they were damaged either in transmission 
or by host when they were received. 

ram Random Access Memory. The number of hardware memory er- 

rors host has experienced, in this case 0. 

bite Bit Count. The number of packets whose actual bit count did 

not match the bit count recorded for them. 

other Other errors. 



Show IDS Children Command 



Show IDS Children file keywords 

Shows file (a world load file) and its IDS children. IDS children are worlds that 
have ben saved using the Save World Incremental command. 



keywords 



:More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 
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:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show IDS Files Command 

Show IDS Files keywords 

Shows the IDS files for the specified host. IDS files are world loads that have been 
saved using the Save World Incremental command. 

keywords :Host, :More Processing, :Output Destination 

:Host The name of the machine whose IDS files you want to see. The 

default host is the local machine. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show IDS Parents Command 

Show IDS Parents file keywords 

Shows the IDS parent worlds for file (a world load file). An IDS parent is the base 
world from which other incremental worlds are made. 

file {pathname} The pathname of an IDS world. 

keywords :More Processing, :Output Destination 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 
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:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Legal Notice Command 

Show Legal Notice keywords 

Displays the Symbolics Legal Notices, such as copyrights and trademarks. 

keywords :More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Lisp Context Command 

Show Lisp Context keywords 

Displays the currently enabled lisp context (Common-Lisp or Zetalisp), the current 
package, and the current input and output bases. For example: 

Common-Lisp syntax is now enabled. 

Package is USER; Input base is 10; Output base is 10. 

keywords :More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 



Page 2700 



subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Login History Command 

Show Login History 

Prints one line for each time the Login command has been used since the world 
was last cold booted. It also shows the logins done during the creation of the 
world load. Each line contains the name of the user who logged in, the name of 
the machine on which the world load was running at that time, and the date and 
time. This command also shows the name of an init file, if one was loaded. If you 
cold boot, log in, and then do Show Login History, the last line refers to your own 
login and all previous lines refer to logins that were done before doing Save World 
(or running zl:disk-save). 

This information is useful to determine how many times a world load has been 
disk-saved, on what machines it was disk-saved, and who disk-saved it. 

The first couple of lines do not contain any date or time, because they were made 
during the initial construction of the world load before it found out the current 
time. Names of users at other sites that are not in the local site's namespace 
search list are qualified with the site's namespace name and a vertical bar. The 
user LISPM is the dummy user used by si:login-to-sys-host when new world loads 
are created. 



Show Machine Configuration Command 

Show Machine Configuration host keywords 

Shows the board-level hardware information about any Symbolics on the same net- 
work as your machine. 

host The name of a Symbolics machine. The default is your ma- 

chine. 

keywords :More Processing, :Output Destination 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
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subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

This information is useful for Symbolics Software Support Personnel. The display 

from Show Machine Configuration on a 3640 looks like this: 

Chassis (PN 170219, Serial 70) in Chassis or NanoFEP: 

Manufactured on 10/6/84 as rev 1, functions as rev 1, ECO level 

Machine Serial Number: 4070 

FEP Version Number: 127 
Datapath (PN 170032, Serial 2958): 

Manufactured on 1/7/85 as rev 3, functions as rev 3, ECO level 
Extended Sequencer (PN 170299, Serial 720) in Sequencer: 

Manufactured on 5/12/86 as rev 1, functions as rev 1, ECO level 
Memory Control (PN 170052, Serial 4102) in Memory Control or IFU: 

Manufactured on 6/11/86 as rev 5, functions as rev 5, ECO level 
Floating Point (PN 170172, Serial 12) in FPA: 

Manufactured on 5/18/84 as rev 1, functions as rev 1, ECO level 
Front End (PN 170062, Serial 3069) in FEP: 

Manufactured on 12/21/84 as rev 5, functions as rev 5, ECO level 
512K Memory (PN 170002, Serial 1758) in LBus slot 00: 

Octal Base address: 

Manufactured on 9/28/84 as rev 2, functions as rev 2, ECO level 
1Meg Memory (PN 170473, Serial 265) in LBus slot 02: 

Octal Base address: 4000000 

Manufactured on 10/3/85 as rev 1, functions as rev 1, ECO level 
10 (PN 170157, Serial 849) in LBus slot 03: 

Octal Base address: 6000000 

Manufactured on 2/21/85 as rev 6, functions as rev 6, ECO level 
512K Memory (PN 170002, Serial 1897) in LBus slot 04: 

Octal Base address: 10000000 

Manufactured on 10/15/84 as rev 2, functions as rev 2, ECO level 
FEP Paddle Card (PN 170069, Serial 377) in FEP — PADDLE side: 

Manufactured on 10/23/84 as rev 1, functions as rev 1, ECO level 
10 Paddle Card (PN 170245, Serial 692) in LBus slot 03 — PADDLE side: 

Manufactured on 6/17/85 as rev 1, functions as rev 1, ECO level 

Ethernet Address: 08-00-05-03-A0-15 



Show Mail Command 

Show Mail pathname keywords 

Displays your mail inbox on the screen. If there is more than one screenful, it 
pauses between screenfuls displaying — More — at the bottom. 
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pathname 
keywords 



The pathname of the mail inbox to be read. The default is the 
default inbox. 

:More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Memory Error Corrections Command 

Note: This command is implemented only on Ivory machines. 

Show Memory Error Corrections keywords 

With no keyword arguments, displays the number of memory errors that have oc- 
curred. 

keywords: :Detailed, :More Processing, :Newest, :Output Destination 



:Detailed 



:More Processing 



: Newest 



{Yes, No} List the logged error correction codes. The default is 
No, the mentioned default is Yes. 

{Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

{a number} The number of items to be output. The default is 
20. 



:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

With the :Detailed keyword, displays the newest 20 error corrections, for example: 
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There have been 38 memory error corrections. 

The newest 20 error corrections are listed. 

The most recent memory error correction is listed first. 



Memory Address 


Check Bit 


2040256 


11 


1532420 


11 


5646204 


11 



ECC Syndrome Disposition 

145 Soft (corrected) error, physical access 

Soft (corrected) error(s), unlogged 

145 Soft (corrected) error, virtual access 

Soft (corrected) error(s), unlogged 

145 Soft (corrected) error, virtual access 



For each error listed, it also lists the kind of error and its disposition. The kind of 
error is either Uncorrectable error or Soft (corrected) error. 

(The former appears only if you successfully used Continue in the FEP when the 
uncorrectable error occurred). 

The disposition is one of: 

repaired by scrubber 

meaning there was an error that could be fixed by rewriting 
the data. 

stuck (call field service) 

meaning there is an error that cannot be fixed by rewriting, 
but if it is a soft error, the correct data is being returned. 
However, it cannot be fixed to give no errors; hence you proba- 
bly have a stuck bit in your memory. 

ignored (corrected data written to disk) 

meaning there was an error that was not worth fixing (the 
good data went to the disk already). 

virtual access meaning an error that has not (yet) been fixed in virtual mem- 

ory by the error scrubber. 

physical access meaning an error that has not (yet) been fixed in physical 
memory by the error scrubber. 

unknown access meaning either a virtual or a physical access error, but we 

cannot figure out which. Most likely this is due to an error 
that occurred in the FEP. 



Show Messages Command 

Show Messages keywords 

Displays the contents of the specified Converse conversations. 
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keywords :Direction, :From, :Mention Empty Sequences, :More Process- 

ing, :Order, :Output Destination, :Query, :Recent, :Start, :Stop, 
:Summarize, :To 

:Direction {Incoming, Outgoing, All, or Default} Whether to show incom- 

ing messages, outgoing messages, or all. The Default is Incom- 
ing. 

:From {user-or-address} Show messages from this user or address. 

:Mention Empty Sequences 

{Yes, No} Whether to mention empty message sequences, for 
example, you have sent messages to someone but the person 
did not reply. The default is No, not to mention this. If it is 
Yes, you see "No messages from so-and-so". 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 



: Order 



{Forward, Reverse} How to order the message presentation 
within each conversation. The default is Forward, that is, most 
recent first. 



:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Query {Yes, No} Whether to ask about each conversation. The default 

is Yes, to ask. 

:Recent {Yes, No} Whether to consider only the most recently ex- 

changed messages in each conversation. 

:Start {number} Number of first message to show in a conversation. 

If there are fewer then number messages in the conversation, 
that conversation is skipped. 

:Stop {number} Number of last message to show in a conversation. 

:Summarize {Yes, No} Whether to show the entire message or just a sum- 

mary. The default is No, to show the entire message. If yes, 
messages are mentioned but not shown. 



:To 



{user-or-address} Show messages to this user or address. 
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Show Monitored Locations Command 

Show Monitored Locations 

Displays all variables and other locations in memory that you are monitoring via 
the Monitor Variable command, the dbgrmonitor-location function, and so on. 

Show Mouse Handlers Command 

Show Mouse Handlers handler-name keywords 

Lists the handlers corresponding to handler-name, showing the input context, pre- 
sentation type, and handler type (object type) to which each is applicable. 

handler-name The name of a mouse handler. 

keywords :More Processing, :Output Destination, :Show Defined Han- 

dlers, :Show Table Handlers 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Show Defined Handlers 

{Yes No} Whether to list the handlers as described above. 

:Show Table Handlers 

{Yes No} Whether to show the expansion of the handlers in 
the handler lookup table. 

Show Namespace Object Command 

Show Namespace Object namespace-object keywords 

Shows the information in the namespace database. 

namespace-object A namespace object is specified by the class of the object fol- 
lowed by the name of the object. For instance, to specify the 
printer named Asahi, you enter: 

Show Namespace Object printer Asahi 
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If namespace-object is described in more than one namespace 
(is "multi-homed"), Edit Namespace Object prompts for the 
namespace in which you want to edit this object. (Typically, a 
namespace object is described only in one namespace.) 

:Format, :Locally, :More Processing, :Output Destination 

{Normal, Detailed} Whether to show fields that are empty. The 
default is normal, to omit empty fields. Detailed shows all 
fields. 

Specifies whether the Show Namespace Object command 
queries the namespace server or uses the values in the current 
Lisp world. 

{Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



keywords: 
: Format 

:Locally 

:More Processing 



Here is what the namespace object for a user might look like: 

Showing USER KJONES in namespace ACME: 

Lispm Name: Kjones 

Personal Name: Jones, Kingsley 

Nickname: King 

Work Address: Building 3-701 

Work Phone: 5891 

Home Host: ACME 

Mail Address: Kjones ACME 

Birthday: 19 June 

Project: Database 

Supervisor: Finklestein 



Show Notifications Command 

Show Notifications keywords 

Redisplays any notifications that have been received. Notifications are asyn- 
chronous messages from Genera. 



keywords 



: Before 



: Excluding 

:From 
:Matching 
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:Before, :Excluding, :From, :Matching, :More Processing, 
:Newest, :01dest, :Output Destination, :Since, :Through 

A date to serve as one limit for notifications to show: 
:before 11/1/89 

A string or sequence of strings to search for. Do not show no- 
tifications containing the string or sequence of strings. 

A number to use as the first notification to show. 

A string or sequence of strings to search for. Only show notifi- 
cations that contain that string: 

:matching hardcopy 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Newest A number of notifications to show, for instance, the ten most 

recent ones: 

: newest 10 

Using this keyword without a number is the same as : newest 
1. 

:01dest A number of notifications to show, for instance, the ten earli- 

est ones: 

: oldest 10 

Using this keyword without a number is the same as : oldest 
1. 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

: Since A date to serve as one limit for notifications to show. 

: Through A number to use as the last notification to show: 

: through 17 

Using the Show Notifications command with no keyword arguments means show 
all notifications in reverse chronological order (most recent first). 



Show Object Command 
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Show Object name keywords 

Show Object tries to tell you all the interesting information about any object (ex- 
cept for array contents). Show Object knows about areas, structures, packages, 
pathnames, systems, variables, functions, flavors, and resources. It displays the at- 
tributes of each. Show Object symbol will tell you about symbol's value, its defini- 
tion, and each of its properties. 

name Any Lisp object. 

keywords :More Processing, :Output Destination, :Type 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Type {All, Area, Structure, Package, Pathname System, Variable, 

Function, Flavor, Resource}. The default is All. 



Show Open Files Command 

Show Open Files keywords 

Shows the files your machine has open for reading or writing and their state. For 
example: 

Command: Show Open Files 

Input file: A:>KJones>mail ._ZMAIL_text. newest (100% read) 

Output f ile: A :>sys>doocp>cp6. sab. newest (7647 bytes written) 

Output file: HATCH :>Print-Spooler>90/04/09. Log. newest (4822 bytes written) 

keywords :More Processing, :Output Destination 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 
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:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Output History Command 

Show Output History dynamic-window keywords 

Displays the output history for the specified window. 

dynamic-window {window} The window whose output history to show. Press 
HELP for a list of the possible windows. 

keywords :More Processing, :Output Destination 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

Show Presentation Handlers From Type Command 

Show Presentation Handlers From Type type keywords 

Lists the handlers defined with type as their from-presentation-type. 

type A presentation type. 

keywords :Include t, :More Processing, :Output-Destination 

:Include t {Yes No} Whether to include in the listing handlers defined on 

the t presentation type. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 
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:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Presentation Type Command 

Show Presentation Type type keywords 

Shows the argument list, supertypes, and subtypes of a presentation type. 

type A presentation type. 

keywords :For Lookup, :Include Predicate, :More Processing, :Output 

Destination 

:For Lookup {Yes No} Whether to list the types examined during mouse 

handler lookup. Listed supertypes for lookup are examined 
when type is the to-presentation-type in a handler definition; 
listed subtypes for lookup are examined when type is the from- 
presentation-type in a handler definition. 

: Include Predicate 

{Yes No} Whether to show, if applicable, the type reduction 
step of type to a supertype and a predicate. For example, the 
symbol presentation type is reducible to the supertype 
sysrexpression and the predicate symbolp. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Printer Defaults Command 

Show Printer Defaults keywords 

Displays the current default printer(s). If you send all your hardcopy output to one 
printer, the command returns: 
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Default Printer (for both text and bitmap output): printer-name 

If you use a different printer for text and screen hardcopy, the command returns: 

Default Text Printer: printer-namel 
Default Bitmap Printer: printer-name2 



Show Printer Status Command 

Show Printer Status printer 

Displays the print queue for the specified printer or printers. 

printer The name of a printer or printers (separated by commas) 

whose print queue you are displaying. Specifying All displays 
the queues for all printers at your site. The default is your 
current printer. If your text printer and your bitmap printer 
are different, the command uses your text printer as the de- 
fault for Show Printer Status. 

The display of requests is mouse sensitive, enabling you to click on select argu- 
ments when using either the Delete Printer Request or Restart Printer Request 
commands. 

Show Processes Command 

Show Processes keywords 

Displays all the processes currently in your environment. See Figure 31 . 

Keywords :Active, :Idle, :More Processing, :Name, :Order, :Output Desti- 

nation, :Priority Above, :Priority Below, :Recent, :State, : Sys- 
tem, :Unarrested 

Active {time-interval} Shows only processes that have been active 

within time-interval. The mentioned default is "1 minute". (Ob- 
solete, use :Recent.) 

:Idle {time-interval} Shows only processes that have been idle for at 

least time-interval. The mentioned default is "1 minute". 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 
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:Name 



: Order 



{process-names-or-substrings} Enables you to specify an existing 
process name, a process name substring, or a combination of 
the two. If you specify substrings only, the processes named by 
those substrings are considered for viewing (subject to the oth- 
er options.) If you specify process names only, only those pro- 
cesses are considered. If you specify a mix, then processes 
named exactly and processes named by substrings are both 
considered. 

{Idle, Name, None, Percent} Sorting method for the processes 
display. The default is None. 



:Output Destination 

{Buffer 



:Priority Above 
: Priority Below 
:Recent 

: State 
: System 

:Unarrested 



File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

{integer} Shows only processes of priority higher than integer. 

[integer] Shows only processes of priority lower than integer. 

{time-interval} Shows only processes that have run within time- 
interval. 

{string} Shows only processes whose state contain string. 

{Yes, No} Shows the system processes also. The default is No, 
the mentioned default is Yes. 

{Yes, No} Shows only processes that are not arrested. The de- 
fault is No, the mentioned default is Yes. 



The priorities are: 

F Foreground 

B Background 

D Deadline 

P Preemptive 

The process names in the display are mouse sensitive. Clicking Middle on one of 
them puts that process in the debugger. Clicking Right pops up a menu of opera- 
tions: 
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Figure 130. Show Processes 



Debug Process Mouse 

Flush Process Mouse (keywords) :Confinn Mouse 

Halt Process Mouse 

Kill Process Mouse (keywords) :Confirrn Mouse 

Re start Process Mous e (keywords) :Confirrn Mouse 

F^art Process Mousel 

Narking and yanking menu 

Presentation debugging menu 

System menu 

Window operation menu 



Show Source Code Command 

:Show Source Code compiled-function-spec keywords 



c-y, c-d 



Displays the source code for a function. This command works only when your code 
resides in an editor buffer. The output is mouse sensitive only when the function 
is compiled with source locators. When you specify a compiled function for which 
you want to see source code — for example, myfunction — the Debugger displays 
the source code for myfunction beneath the following message: 

Source code for MYFUNCTION: 
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If myfunction were not compiled with source locators, the Debugger would still 
display the source code, but the output would not be mouse sensitive. The Debug- 
ger would display the source code only after giving you this message: 

Function MYFUNCTION has no source locators; the code will not be sensitive. 

compiled-function-spec 

The name of a compiled function for which you want to see 
source code. (Default is the function in the current frame.) 

keywords :More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

Suggested mouse operations 

When a function has been compiled using source locators — mapping source code 
to PCs via the editor's c-n-sh-C command — you can perform the following mouse 
operations: 

• To use this command with the mouse: Type in the :Show Source Code command. 
When the Debugger asks you for a compiled-function-spec, point the mouse at 
the name of a compiled function previously displayed in the output of another 
command, such as :Show Backtrace, and click Left. 

• To set a breakpoint: Point the mouse at a form (a code fragment) in the dis- 
played source code and press c-n-Left. 

• To clear a breakpoint: Point the mouse at a form (a code fragment) in the dis- 
played source code and press c-n-Middle. 

• To evaluate a code fragment: Point the mouse at a form in the displayed source 
code and press n-Middle. 



Show Standard Value Warnings Command 
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Show Standard Value Warnings keywords 

Displays more detailed information about standard variables that have been re- 
bound. Here is an example of what the Debugger displays when you enter this 
command: 

— > :Show Standard Value Warnings 

The following standard values were bound: 

Rebinding CP:*COMMAND-TABLE* to #<COMMAND-TABLE User #o260252757> 
(old value was #<COMMAND-TABLE Debugger #o261747137>) 

—> 

If no standard variables have been rebound, the Debugger tells you: 
There were no standard values which required binding 

keywords :More Processing, :Output Destination 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

See the section "Standard Variables". 



Show System Components Command 

Show System Components system keywords 

Shows the systems included in system and graphs their dependencies. If system is 
loaded, it also shows the current system version and patch level. See Figure 

I 

system A system or subsystem whose components to show. 

keywords :More Processing, :Output Destination 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
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command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

Command : Shou System Components (a subsystem or a system [default System]) Lisp Compiler 
L Lisp Compiler Newestl |L Architecture Newestl 



Lisp Compiler Newest 



I Lisp Compiler I Architecture 



Figure 131. Show System Components Lisp Compiler 

Show System Definition Command 

Show System Definition system-or-subsystem keywords 

Displays a the system definition of system including its current patch level, status 
(experimental or released), and the files that make up the system. 

system-or-subsystem The system whose definition to display. 

keywords :Detailed, :More Processing, :Output Destination, :Use Jour- 

nals, :Version 

:Detailed {Yes, No} Whether to display the information about all the 

component systems of the system or not. The default is No, the 
mentioned default is Yes. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Use Journals {Yes, No} Use the information in the system's journal files in- 
stead of the information loaded into the world. The default is 
No, the mentioned default is Yes. 



Page 2717 



:Version 



{version-designator} What version of the system for which to 
display the definition. The default is :Released. 



Show System Modifications Command 

Show System Modifications system-name keywords 

With no arguments, Show System Modifications lists the locally maintained sys- 
tems present in this world and, for each system, all the modifications that have 
been loaded into this world. For each modification it shows the major version num- 
ber (which is always the same, since a world can only contain one major version), 
the minor version number, and an explanation of what the modification does, as 
entered by the person who made it. 

If Show System Modifications is called with an argument, only the modifications to 
system-name are listed. 

system-name {All, Local, system-namel, system-name2 ... } The system for 

which to show modifications. The default is All. 

keywords Author, :Before, :From, :Matching, :More Processing, :Newest, 

Number, :01dest, :Output Destination, :Reviewer, :Since, 
Through 

Author A name. Show modifications by a particular person. For exam- 

ple: 

:show modifications system :author kjones 

would only show those modifications made by the person whose 
user ID is kjones. 

:Before A date to serve as one limit for modifications to show: 

: before 1/23/90 

:From A number to use as the first modification to show. 

:Matching A string to search for in the comments and show only modifi- 

cations whose comment contain that string: 

: matching namespace 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 
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:Newest A number of modifications to show, for instance the ten most 

recent ones: 

: newest 10 

Using this keyword without a number is the same as : newest 
1. 

:Number A number. Show only this particular modification. For example: 

Show Modifications :number 6 
would show modification number 6. 

:01dest A number of modifications to show, for instance the ten earli- 

est ones: 

: oldest 10 

Using this keyword without a number is the same as : oldest 
1. 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Reviewer A name. Show modifications reviewed by a particular person. 

: Since A date to serve as one limit for modifications to show. 

: Through A number to use as the last modification to show: 

: through 17 



Show System Plan Command 

Show System Plan system operation keywords 

Show the system plan (the order of operations) for the specified system under the 
specified operation. 



system 
operation 



The system for which to show the plan. 

The operation for which to show the plan. The available opera- 
tions are: 



All 

Compile 

Copy 

Copy-Toolkit-C-Files 

Write-Toolkit-C-Files 



Count-Lines-In Kludge-Load 

Distribute Load 

Edit Load-Patches 

Hardcopy Reap-Protect 



keywords 



:Date Checking, :Detailed, :More Processing,:Output Destina- 
tion, :Version 
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:Date Checking {Yes, No} Compare files against the file system. The default is 
No, the mentioned default is Yes. 

:Detailed {Yes, No} Whether to describe the plans for component sys- 

tems. The default is No, the mentioned default is Yes. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Version Version of the system for which to construct plans. The default 

is Released. 



Show System Version Designations Command 

Show System Version Designations systems keywords 

Shows the versions of each system that have been given a name indicating their 
status, for example Latest, Released, Experimental, Obsolete, or any other token. 

systems The name(s) of a system or systems whose version designations 

to show. The systems do not have to be loaded into the world. 

keywords :More Processing, :Output Destination 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

For example: 
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Show System Version Designations (systems [default IP-TCP]) IP-TCP, fortran 
Version designations for system IP-TCP 



Latest 


411 


System-350 


53 


System-349 


52 


System-347 


49 


Release-6-g 


29 


Release-6-1 


29 


Release-6-0 


29 


Release-5-2 


23 


Release-5-1 


12 



FORTRAN is unknown; looking for Q :>sys>site>fortran. system. newest. . . reading... read. 
Version designations for system Fortran 

Fortran-11 11 

Latest 404 

Released NIL 

Fortran-10 10 



Show Table of Contents Command 

Show Table of Contents topic keywords 

Shows the table of contents of the documentation topic. 

topic A topic which is documented and accessible in Document Ex- 

aminer. 

keywords :Crossreferences, :Depth, :More Processing, :Output Destina- 

tion, :Sources 

:Crossreferences {Yes, No} Whether to display crossreferenced topics. The de- 
fault is No. 

:Depth {integer} How many levels deep to display. The default is to 

show all levels. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
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Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Sources {Yes, No} Whether to display associated source files. The de- 

fault is No. Note that in a world with a compressed documen- 
tation database, the source file information is not available. 



Show TAR File Command 

Show TAR File tarfile keywords 

Shows the contents of a TAR tape. 

tarfile {a pathname} The file to be read. 

keywords :More Processing, :Output Destination 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} En- 
ables you to direct your output. The default is the stream 
*standard-output*. Note that redirecting output to a printer 
can be particularly useful. 

Show TAR Tape Command 

Show TAR Tape keywords 

Shows the contents of a TAR tape. It prompts for the tape specification. 

keywords :More Processing, :Output Destination 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} En- 
ables you to direct your output. The default is the stream 
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*standard-output*. Note that redirecting output to a printer 
can be particularly useful. 



Show Time Command 



Show Time keywords 



Displays the current day, date, and time. 



keywords 

:More Processing 



:More Processing, :Output Destination 

{Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Show Users Command 

Show Users user-spec keywords 

Shows the users logged into host. 

user-spec 



keywords 
: Format 



{user, user@host, user@site, @host, @site) The user or users to 
locate and the host or site to search. The default is to show all 
users logged in at the local site. 

:Format, :More Processing, :Order, :Output Destination 
{Brief, Normal, Detailed} How much information to display. 



Brief Gives the user's login name, the host name and 

the idle time only. 

kjones wombat 1:12 

Normal Gives the user's full name and information about 
the world they are running in addition to the in- 
formation displayed by brief. 

kjones Kingsley Jones Wombat 1:12 Computer Room (x515) (Release 7.2) 

Detailed Displays the information in the user's namespace 
object. 
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The default when only one user is specified is normal, if more 
than one is specified the default is brief. 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Order {Host, Idle, User} The order in which to sort the entries in 

the display. 

Host Sorts alphabetically by host name. 

User Sorts alphabetically by user login name. 

Idle Sorts by idle time, from active to greatest idle 

time. 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Start Commands 

Start GC Command 

Start GC keywords 

Controls the operation of the Garbage Collector. Start GC with no keywords turns 
on both dynamic and ephemeral garbage collection. 

keywords :Cleanup, :Dynamic, :Ephemeral, immediately, :Selective 

:Cleanup {Yes, No, Ask} Whether or not to run GC Cleanups to attempt 

to free address space. The default is No. The mentioned de- 
fault is Yes, which does the maximum cleanup possible. Ask 
queries you about each cleanup before performing it. Start GC 
:Cleanup without other keywords does not perform a GC or al- 
ter the mode of the background GC. See the section "GC 
Cleanups". 
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Connand: : Start GC :Cleanup (Yes, No, or Rsk [default Y 

GC Cleanup Tasks 

Reset all input histories? Yes No 

Reset all presentation histories? Yes No 

Reset all editor histories? Yes No 

Reset LISP-TOP-LEUEL variables such as '* and '+? Ye 

Reset interactor output histories? Yes No 

Clear sone resources? Yes No 

< abort > aborts, <1S1> uses these values 

:Dynamic {Yes, No} Enables or disables the dynamic level of incremental 

GC. 

:Ephemeral {Yes, No} Enables or disables the ephemeral level of incremen- 

tal GC. 

immediately {Yes, No, In-Place, By-Area} Performs a complete garbage col- 

lection right now. The mentioned default is Yes. In-Place 
garbage collection does not copy objects; rather, it compacts 
good objects to the bottom of each region. Since there are nev- 
er two copies of an object during the garbage collection, the 
virtual memory (paging space) required for GC is reduced. It is 
slower and non-interruptable, and thus is recommended only 
when execution speed and interaction are not important and 
when there is insufficient disk space for normal garbage col- 
lection. 

Start GC : Immediately By- Area is the same as Start GC : Imme- 
diately Yes Selective Yes. 

Start GC immediately also offers to run GC Cleanups. 

Selective {Yes, No} Specifies areas in which to collect garbage. When 

your address space has shrunk to where there is not quite 
enough free space for Start GC immediately to complete, Se- 
lective suggests some areas to flip that will maximize the 
amount of space reclaimed without risking running out of 
space completely. Selective can be used with both Start GC 
immediately Yes and Start GC immediately In-Place. 

For more information about the process of Garbage Collection, see "Theory of Op- 
eration of the GC Facilities" and "Invoking the Garbage Collection Facilities". 



Start Printer Command 

Start Printer printer 

Starts the specified printer printing its print queue after you halt it. 

printer The name of the printer you are starting. 
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Note that you can halt, start, or reset a spooled printer from any machine on the 
network. For more information, see the section "Halt Printer Command". 



Start Process Command 

Start Process process 

Starts a process that has been halted with Halt Process. 

process A process. You can press HELP or use the Show Processes com- 

mand for a list of all the processes currently running in your 
environment. 



Unmonitor Commands 

Unmonitor Variable Command 

Unmonitor Variable symbol keyword 

Stops monitoring one or all special variables in memory. 

symbol {location, RETURN} A location specifies one location that you 

want to stop monitoring. Enter the name of a symbol and, op- 
tionally, its Value-Cell or Function-Cell. (See the :Cell keyword 
description below.) Press the RETURN key if you want to stop 
monitoring all locations. 

keyword :Cell 

:Cell {Value-Cell, Function-Cell} Specifies which cell within the loca- 

tion you want to stop monitoring. The Debugger gives you two 
choices: Value-Cell or Function-Cell. (Default is Value-Cell.) 

Suggested mouse operations 

• To unmonitor a location: Point the mouse at a locative, structure slot, or in- 
stance variable that was previously monitored and press c-n-sh-Middle. 



Undelete Commands 

Undelete File Command 
Undelete File pathname keywords 
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Undeletes a deleted file, if the host on which the file resides supports undelete. It 
prompts for the name of a file to undelete. It displays a message if the specified 
file does not exist. 

pathname The pathname of the file to be undeleted. The default is the 

usual file default. 

keywords :More Processing, :Output Destination, :Query 

:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Query {Yes, No, Ask} Whether to ask for confirmation before remov- 

ing the delete flag on the file. The default is No. 



Verify Commands 

Verify Distribution Command 

Verify Distribution keywords 

Reads a Distribution from tape, floppy, or disk, and compares the contents of each 
file in the distribution to the corresponding file in the file computer. As the files 
are being compared, a line is typed out for each, to note which file is currently be- 
ing compared. If there is any discrepancy in length or data, a proceedable error is 
signalled, describing the failure to compare. 

The Verify Distribution command is useful when: 



• 



A new distribution has just been created: the tape, floppy, or disk can be 
checked quickly against its sources for validity. 

A distribution has just been restored at a client site: the files created can be 
verified quickly against the distribution on tape, floppy, or disk. 
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keywords :More Processing, :Output Destination, :Use Disk 



:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Use Disk On all machines other than a Maclvory, the choices are {Yes, 

No}. If Yes, the input is read from a tape image file on disk. 
The default is No. The mentioned default is Yes. 

On a Maclvory, the choices are {Tape, Disk, Floppy}. Disk indi- 
cates the hard disk, and Floppy indicates the floppy disk. These 
two values also read a tape image file from disk or floppy. 
Tape means to read from tape; this is the default. 



Write Commands 



Write Carry Tape Command 

Write Carry Tape pathname(s) keywords 

Dumps a file or set of files to a Carry-Tape. See the section "The Carry-Tape 
Dumper". You can dump any type of file. Character files are dumped and reloaded 
using the Genera character set as an interchange medium. Binary files are 
dumped and reloaded with the proper byte size as long as either of the following is 
true: 

• The file is of one of the system's known canonical types. 

• The operating system on which the file resides knows and can supply the byte 
size. 

pathname The pathname(s) of the file(s) to write on the tape. 

keywords :Author, :More Processing, :Output Destination, :Query, :Since, 

:Tape Spec, :Verify 

:Author Dump files written by specific user(s). 
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:More Processing {Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Query {Yes, No} Whether to ask before dumping files to tape. The 

default is Yes. 

:Since Dump files newer than the date specified. 

:Tape Spec The host and device for the tape. The default is the default 

drive on the local machine. For more information, see the sec- 
tion "Tape Specifications". 

:Verify {Yes, No} Whether to compare the tape against the disk after 

dumping. The default is No. 



Write Image File Command 

Write Image File image pathname format keywords 

Saves an image in a file. 

The image to be written to a file. 
The file in which to save the image. 



image 

pathname 

format 



The format of the data in the file. The possible image file for- 
mats are: 



BIN 

Compact Bitmap 
EPS/Macintosh 

MacPaint 

PICT 

Portable Bitmap 



Symbolics binary file (data only, compatible 
with all architectures) 

X windows "compact" bitmap 

Postscript in the data fork, PICT in the re- 
source fork 

MacPaint canvas (fixed size) 

Macintosh picture record 

X windows "portable" bitmap (l's and O's) 
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PostScript 

TIFF 

X Bitmap 



Reads any PostScript images, writes EPSF 
compatible 

Tagged Image File Format 

X windows bitmap (C code) 



keywords 

:More Processing 



:More Processing, :Output Destination 

{Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination {Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 



Write Partition Map Command 

Write Partition Map SCSI-address keywords 

Writes a new partition map on an optical disk. This command erases any data or 
partitions already on the disk. 



SCSI-address 
keywords 



The SCSI address of the optical disk drive. 

:Partition Map Size, :Apple Driver Size, :Apple Hfs Size, 
:FEPFS Size 



The keywords enable you to control the size of four partitions. The values are in 
number of blocks, or Rest. If you supply keywords, three of the partitions should 
be specified as integers, and one should be Rest (indicating that the remaining 
space should be used for that partition). 

:Partition Map Size 

The default is 40 blocks. 

: Apple Driver Size 

The default is 30 blocks. 

Apple Hfs Size The default is blocks. 

:FEPFS Size The default is Rest. 
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Write TAR File Command 

Write TAR File pathnames 

Writes a File in TAR format. 

pathnames The pathnames of the file(s) to write. 

keywords :More Processing, :Output Destination, :Relativize, :Since 

:Mode {Binary, Heuristicate, Query, Text} Mode in which to perform 

the copy. Binary means binary bytes with no character set 
translation. Heuristicate means try to determine automatically 
per file. Query, the default, means ask for each file. Text 
manes text characters with UNIX character set translation. 

:More Processing 

{Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION M"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Relativize {Yes, No} Whether to try to write the pathname as a relative 
UNIX pathname, that is relative to the current UNIX directory 
instead of starting at root. The default is No. The mentioned 
default is Yes. 

:Since {universal-time-in-the-past} Writes only files later than the 

specified date. 



Write TAR Tape Command 

Write TAR Tape pathnames 

Writes a tape in TAR format. It prompts for the tape specification. 

pathnames The pathnames of the files to write on the tape. 

keywords :More Processing, :Output Destination, :Relativize, :Since 



:Mode 



{Binary, Heuristicate, Query, Text} Mode in which to perform 
the copy. Binary means binary bytes with no character set 
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translation. Heuristicate means try to determine automatically 
per file. Query, the default, means ask for each file. Text 
manes text characters with UNIX character set translation. 

:More Processing 

{Default, Yes, No} Controls whether **More** processing at 
end of page is enabled during output to interactive streams. 
The default is Default. If No, output from this command is not 
subject to **More** processing. If Default, output from this 
command is subject to the prevailing setting of **More** pro- 
cessing for the window. If Yes, output from this command is 
subject to **More** processing unless it was disabled globally 
(see the section "FUNCTION N"). 

:Output Destination 

{Buffer, File, Kill Ring, None, Printer, Stream, Window} 
Where to redirect the typeout done by this command. The de- 
fault is the stream *standard-output*. 

:Relativize {Yes, No} Whether to try to write the pathname as a relative 
UNIX pathname, that is relative to the current UNIX directory 
instead of starting at root. The default is No. The mentioned 
default is Yes. 

:Since {universal-time-in-the-past} Writes only files later than the 

specified date. 



Login Functions and Variables 

After cold booting, you are in a window named Dynamic Lisp Listener 1. You are 
now ready to log in. Logging in tells Genera who you are, so that other users can 
see who is logged in, you can receive messages, and your init file can be run. An 
init file is a Lisp program that is loaded when you log in; you can use it to set up 
a personalized environment. 

If your login name is KJones, you can log in in any of the following ways. (Note 
that the examples are given in uppercase and lowercase, but the machine is not 
case sensitive. You can use all uppercase, all lowercase, or mixed case as you 
prefer.) 

• To log into the default host machine, using your init file, type 

Login KJones 

• To log into your machine, without your init file, type 

Login KJones :init file none 

• To log into another machine "sc3", using your init file, type 



Page 2732 



Login KJones :host sc3 

If the host machine you log in to is a timesharing computer system, you must 
have a directory and account on that system. 

For information about how to write init files, see the section "Customizing 
Genera". 

When you log out, it should be possible to undo any personalizations you have 
made so that they do not affect the next user of the machine. Therefore, anything 
done by an init file should be undoable. Thus, for every form in the init file, you 
should add to the list that is the value of sys:logout-list a Lisp form to undo its 
effects. The functions login-forms and zl:login-setq help make this easy. 



Login Command 

Login user keywords 

Logs the user into Genera. 

user Any string. Your user ID. 

keywords :Host, :Init File 

:Host {Local, any-host-name} A particular host computer. Local as an 

argument to :Host is particularly useful if your namespace sys- 
tem is down and you wish to log in to your Machine without 
having it try to use the namespace database. The default 
comes from home host for your user object in the namespace 
database. 

:Init File {Default-Init-File, File, Pathname, None} Whether to load your 

init file. The default is Default-Init-File. To avoid loading your 
init file, use :Init File None. 

If someone is already logged in when you give the Login command, that user is 
logged out. If this happens, you see the message 

Warning — You are logging out from program-name 



zhlogin user-name &key :host (:load-init-file t) :no-query -when-unknown : init- file-to- 
load Function 

Logs the user user-name in to Genera, host is a particular host computer. If the 
value of load-init-file is t, as it is by default, the user's init file is loaded from 
host. If the value of load-init-file is nil the init file is not loaded. This is the Lisp 
version of the Login command in the Command Processor. See the section "Login 
Command". 
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The user object in the namespace database that contains your user-name also con- 
tains the name of the host(s) where your mail and init files reside. Therefore, you 
seldom need to supply a host argument to zhlogin. 

You can log in as a registered user by not specifying a host, or you can log in to a 
specific host as a user on that host, not registered in the Genera namespace 
database. 

If host requires passwords for logging in, you are asked for a password. When log- 
ging in to a TOPS-20 host, typing an asterisk before your password enables any 
special capabilities you might be authorized to use. 

If anyone is logged in to the machine already, zhlogin logs that user out before 
logging in user-name. See the function zhlogout. zhlogin also runs the rlogin ini- 
tialization list. See the section "System Initialization Lists". 

When zhlogin loads an init file, it looks for a file whose name depends on the 
host. See the section "Init-File Naming Conventions". Init files should be written 
using login-forms so that zhlogout can undo them. Usually, however, you cold 
boot the machine before logging in, to remove any traces of the previous user. 

A typical use of zhlogin looks like this: 
(zl : login 'kjones) 

A typical use of zhlogin to avoid loading your init file looks like this: 
(zl: login 'kjones : load-i nit-file nil) 

Supplying all the arguments might look like this: 

(zl:login 'kjones :host local : load-i nit-file nil) 

The host local is particularly useful if your namespace system is down and you 
wish to log in to your machine without having it try to use the namespace 
database. 

If you supply an unknown user id and do not specify :host, you are given an op- 
portunity to specify a particular host for the current login session, and to add the 
user object thus created to the network database (accomplished via Edit Name- 
space Object or tvredit-namespace-object) for subsequent logins. You can instead 
select the Retry option, which is useful when the namespace server did not re- 
spond to your initial zhlogin request. 

The :no-query-when-unknown and :init-file-to-load keywords are for internal use 
by the system, and are not intended for users. 



zhlogout Function 

First, zhlogout evaluates the forms on sys:logout-list. Then it sets zhuser-id to 
an empty string and sys:logout-list to nil. Then it runs the rlogout initialization 
list and returns t. See the section "Initializations". 



zhuser-id Variable 
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The value of zl:user-id is either the name of the logged in user, as a string, or an 
empty string if there is no user logged in. It appears in the status line. 



sys:logout-list Variable 

The value of sys:logout-list is a list of forms that are evaluated when a user logs 
out. 



login-forms &body forms Function 

A special form for wrapping around a set of forms in your init file. It evaluates 
the forms and arranges for them to be undone when you log out. 

login-forms always evaluates the forms, even when it does not know how to undo 
them. For forms that it cannot undo, it prints a warning message. 

In the following example, login-forms arranges for the base to be reset at logout 
to 10 (the default) and for bar either to become undefined or to get its old func- 
tion definition. It would warn you about quux being impossible to undo. 

(login-forms 

(zl :setq-standard-value base 8) 
(zl :setq-standard-value ibase 8) 
(defun bar (x y) (+ x y)) 
(quux 3)) 

You can create functions to undo forms that login-forms does not recognize. To 
undo a given form, you put a property on the symbol that is the car of the form to 
undo. For example, to create a function to undo quux: 

(defun (:property quux :undo-f unction) (form) 
1 (undo-quux , (cadr form))) 

The value returned by an undo function is a form to be evaluated at logout time. 



zhsetq-globally &rest vars-and-vals Function 

Use the Symbolics Common Lisp function symbol-value-globally instead of this. 
You use setf with symbol-value-globally to set global values in your init file. 



